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GENERAL 


This document defines the Network Definition Language (NDL) for the 
B170)0. It is intended to serve as both a formal specification of 
the language and as a programmer's guidee The reader . should be 
somewhat familiar with 1) Burroughs Data Communication procedures 
and hardware» and 2) Bi700 NOL software system architecture. 


RELATED PUBLICATIONS 


B17)30 Data Communications Functional Description 
B17)90 NOL/LIBRARY (P.S- 2212 5215) 
B1700 Message Control System (MCS) Manual 
B17)0 NDL Reference Manual C# 1073715) 
DC/YAUDIT Technicat Documentation and 
Qoerating Instructions 
B1700 Data Comm Audit (P.S. 2212 5421) 
B1i7)0 RJE/Terminal (NOL) CP.S. 2212 5249) 


The functional description should be read before the NOL Reference 
Manuals Since tt describes the overalt B1700 NOL system. The MCS 
manual will be of value to anyone who needs the additional features 
of message control system in their Datacomm System. 
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THE STRUCTURE OF NOL 


NOL is a higher-order language for Data Communications. [t provides 
a simple means of generating’ a 81700 Network Controller (NC). If a 
network is changed» the system can be quickly = and easily 
regenerated by recompiling. A network is defined by specifying in 
NOL source code the network attributes: The physical devices in the — 
network Ctlines» terminals» adapters» etc.e)» the Line discipline to 
be used C™REQUESTS™)» the order and oprtority of Line use 
C*CONTRILS")» and the grouping of stations into files. 


An NDL drogram consists of the following sequence of sections: 


SZCTION | FUNCTION 

DECLARATION Constants audit files and- MCS signal 
character definition 

REQJEST Code for Line disciplines for each type of 
remote device ("TERMINAL") 

CONTROL Code to decide the order and opriority of 
line use. 

TERYINAL Lists the attributes for each type of remote 
device 

STATION Lists the attributes for every remote device 


in the network. 


LIN: ° Lists the attributes for each tine in the 


network 
PILe Groups stations into logical files 


The NOL compiler translates the source into two outputs: 


1) The Network Information File (NIF)» a file of tables 
describing the physical and logical attributes of the 


network. 


2) The Network Controttler Codefile. REQUESTS and CONTROLS 
are compiled into code and incorporated as subroutines 
in the codefile. The NIF contains the initialization 
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values for the controller's Lines stations terminal» 
and file tables. 
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CODING AIDS 


NDL source language preparation can be simplified by using’ the 
coding aids provided by the compiler. Common datacomm control 
characters have been predefined. For examples» the symbots "ETX™ and 
"SIX" are recognized by the NDL compiler to signify the hexadecimal 
strings 4703" and 4"02" respectively (See DECLARATION SECTION). 
Most users shoutd find it unnecessary to write their own REQUESTS 
and CONTROLs“-the source Language library (C&LIBRARY) contains 
REQUESTs and CONTROLs to handte common Line disciplines and tine 
driving techniques. Default definitions (See TERMINAL SECTION) may 
be used in the terminals» stations Lines and file sections to reduce 
the coding required. 


SYNTAX CONVENTIONS 


This section describes the Backus-Naur Form CBNF) to define’ the 
syntax »9f the Network Definitton Language. 


METALINGUISTIC SYMBOLS 


The following metalinguistic symbols witl pe used in this document: 


< > Left and right broken brackets are used to contain one or 
more digits and/or letters representing a metalinguistic 
variable whose definition is given by a metatinguistic 
formula. 


The symbol “"s:=" means “IS DEFINED AS". The metalinguistic 
variable to the Left of this symbol is defined by the 
metalinguistic formula on its right. 


! The symbol "i" means “OR". It separates alternative 
definitions of a metalinguistic variable. 
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METALINGUISTIC FORMULAS 


Metalinguistic symbols are used in forming a metalinguistic formula. 
A metalinguistic formula is a rule which witlt produce an atlowable 
sequenc? of characters and/or symbols. These formulas are used to 
define the syntax of the 81700 Network Definition Language. The 
syntaxep combined with the semantics contained in this product 
specification» defines the 81700 Network Definition Language. 


Any mark or symbol in a metaltinguistic formula which is not one of 
the metalinguistic symbols» is equivalent to itself. The 
juxtaposition of the metalinguistic variables and/or symbols in a 
metalinguistic formula denotes the juxtaposition of those elements 
in the construct indicated. 


An examole of a metalinguistic formula is: 


<IDENTIFIER> 22= <LETTER> | <IDENTIFIER> <LETTER> 1 
| <IDENTIFIER> <DIGIT> 


This metalinguistic formula is read: 


An Ldentifier is defined as a tetter»s or an identifier 
followed by a letter» or an identifier followed by a digit. 


The metalinguistic formula above defines a recursive relationship by 
which a construct called an identifier may be formed. That ise 
evaluation of the formula shows that an Identifier begins with a 
letter. The letter may stand alone» or may be fotlowed by any 
sequence of letters and digits. 
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BASIC ELEMENTS OF THE LANGUAGE 


CHARACTER SET 


The NOL character set ts drawn from EBCDIC graphics» but any EBCDIC 
character is valid in an <EBCDIC STRING>. The Datacomm System is 


internally EBCDIC. Where appropriate all characters are translated» 
as for example» when transmitting to a NON-ES8CDIC devicee These 


subsets of EBCDIC characters will be used in the following SNF: 


<EBCOIC CHARACTER>?22= <LETTER>. 
1! <DIGIT> 
1 <SPECIAL CHARACTER> 
1 <SLASH> 
1 <VERTICAL BAR> 
1 <BLANK> 
<LETTER> 222 7 AIBICle oe IXIYIZ 
<OIGIT>::= OllL bees 1819 
<SPECIA. CHARACTER>:2= “I< SLASH> ICID be iSdo1 <i >le 1749 
| ICL14#1=0<VERTICAL BAR>II<BLANK> 
<SLASH>::2= | / 
<VERTICAL BAR>?2?= i 


<BLANK>:= CONE GRAPHIC SPACE = HEX 40) 


ene 
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The prinitives of the NOL language. 


<BASIC COMPONENT>:3= <IDENTIFTIER> 
<INTEGER> 
<STRING> 
<OPERATOR> 
<LOGICAL VALUE> 
<BRACKETS> 
<SEPARATOR> 
<ASSIGNER> 
<VARIABLE> 


IDENTIFIERS 


<LETTER> 
| <IDENTIFIER> <LETTER> 
| <IDENTIFIER> <OIGIT> 


<IDENTI- IER>?: 


RESTRICTIONS: A) There is no maximum on [dentifier Length» but 
only the first 10 characters wilt be used by the 
compiler. i 


B) Identifier must be unique Ci.e.~.Two REQUESTs~ may 
not have the same Identifier). 


INTEGERS 


<INTEGEW%>28= <DIGIT> 
1 <INTEGER> <OIGIT> 


Integers are loaded as 24-bit binary numbers. 
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STRINGS 
SYNTAX? 
<STRING>::= <HEXADECIMNAL STRING> 

t <EBCDIC STRING> 

<HEXADECIMAL STRING>:s= 4&A"™CHEX CONCATENATION>* 
<HEX COUNCATENATION>: s= <HEX CHARACTER> <HEX CHARACTER> 


1 <HEX CONCATENATION> <HEX CHARACTER> 
<HEX CHARACTER> 


NOTE = 4EX CHARACTERS ARE ADDED BY TWOS. 


<HEX CHARACTER>: 2 = <DIGIT> tAIBICIDIEIF 


i 


<EBCDIC STRING>:: "<EBCDIC CONCATENATION>" 
<EBCDIC CONCATENATION>::= <EBCDIC CHARACTER> 
l <EBCOIC CHARACTER> <EBCDIC 
CONCATENATLION> 


SEMANTICS: 


Any cBC)IC character may appear in an EBCDIC stringe An internal 
quote is represented by two consecutive quotes. For example: """* 
represents an EBCDIC string of one single quotee The maximum length 
of a Hexadecimal string is 40 bits» or 10 Hexadecimal digits. 
Maximum length of a EBCDIC string is 40 characters. 
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OPERATORS 

SYNTAX: 
<OPERATIR>::= <UNARY OPERATOR> 

| 1 <BINARY OPERATOR> 
<UNARY JPERATOR>?::= + | - t NOT 
<BINARY OPERATOR>::= <ARITHMETIC OPERATOR> 


1 <LOGICAL OPERATOR> 
1 <RELATIONAL OPERATOR> 


<ARITHMZ TIC OPERATOR>: s= # | -~ ¢ * { <SLASH> 

<LOGICAL OPERATOR>?:= AND 1 OR 

<RELATIQNAL OPERATOR>3:= EQ ! NE € GT 1! GE ULT § LE | = t > | 
SEMANTICS: 

Operators are used in expressions (See EXPRESSIONS). Binary - 
operators require two operandss as tn "10 * 3" » unary operators 
only ones as In “NOT BREAK™. The alphabetic relational operators 


are abbreviations: 


EQ Equal 

NE Not Equal 

GT Greater Than 

GE Greater Than or Equal 
LT : Less Than 


LE Less Than or Equal 
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LOGICAL VALUES 


SYNTAX: 


<LOGICA. VALUE>::= TRUE € FALSE 


SEMANTICS: 


TRUE is equivalent to the integer 1» and FALSE to 0. For example the 
expresston "BREAK EQ TRUE" could have been "BREAK EQ 1". 
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BRACKETS 
SYNTAX: 
<BRACKET>s3= Ci) 4 €t § Jj 


SEMANTICS: 


Parentheses normally signify a modification or variant form of the 
precediag symbol, for example “TRAN CTRANSMIT)®% and “TRAN 
CRECEIVZ)". True brackets are used for subscripts of TOG and TALLY. 


SEPARATORS 
SYNTAX: 
<SEPARATOR>3: s= y | « € &= § <SPACE> 
<SPACE>: s= | . <BLANK> § <SPACE> <BLANK> 


SEMANTICS: 


Note that one blank or any number of blanks may be used to separate 
basic components. These statements are equivalent: 


rs ' MYUSE=INPUT»OUTPUT. 
2.  MYUSE = INPUT» OUTPUT. 
a. MYUSE 

INPUT 


? 
OUTPUT 
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ASSIGNER 

SYNTAX: 


oe 
ul 


<ASSIGNIR>s2= ! <VERTICAL BAR> 


SEMANTIZS: 


The <ASSIGNER> is used tn assignment statements tn the REQUEST and 
CONTROL sections. Example: 


TOSCO]. = TRUE. 
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VARIABLES 
SYNTAX: 


<VARIAB_LE>3s3= <SYSTEM STATUS VARIABLE> 
. <ERROR FLAG> 

<USER TOGGLE> 

<USER TALLY> 

<STRING FUNCTION> 


SEMANTICS: 


NOL provides no means of declaring data areas like COBOL's 
WHORKING"*STORAGE™ or UPL/SDL*s "“DECLARE™. In the REQUEST and 
CUNTROL sections» the NOL programmer must use a set of predefined 
identifiers to test or set the value of system ttemse ALl of the 
variablas may appear tn an expression in either Cor in some cases» 
both) REQUESTs or CONTROLsS.- Avzout half of the variables may have 
their vatue changed explicitly in a REQUEST or CONTROLs that is, 
they may appear on the left side of an <ASSIGNER> in an assignment 
statement. The remainder are read only» See the following table as 
to where a specific variable can be referenced and whether it can 
be assigned. 


Except for "*TIME*» system status variables refer to items in the 
Network Controlter's lines stations or terminal tables. *TIME™: is 
an MCP communtcate. 
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VARI ABL=:: ASSIGNABLE SIZE IN 
CYES=*) BITS: 


SYSTEM STATUS VARIABLES: 


CHAR. CHARACTER « 8 
FREQUENCY CINPUT) | 8 
FREQUENCY COUTPUT) | 8 
LOJESC : 144 + 144 = 288 
IN2UTATTACHED | 1 
OUTPUTATTACHED 1 
LENGTH CINPUT) 12 
LENGTH COUTPUT) | 12 
LINE 8 
LINE CCONTROL KEY) 5 
LINE (QUEUED) 1 
MAX STATIONS | 7 10 
RESULTDESC | 2h + 26 = 48 
RETRY | “ 8 
STATION «(CONTROL ) 10 
STATION CENABLED) ) 1 
STATION (MYUSE) 2 
STATION CQUEUED) .* 4 1 
STATION (READY) 7 1 


STATION CTYPE) 2 
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VARIABL=z? ~ + ASSIGNABLE: | “SIZE IN 


CYES=«) | BITS: 


SYSTEM STATUS VARIABLES (CONT.) 


TERMINALTYPE 6 
TIME. 20 
TRAN CRECEIVE) & Be 16524 


TRAN CTRANSMIT) * . 816224 


ERROR F_AGS: 


ADJERR * | 1 
BREAK ‘ 4 
ACCESSERR ok 1 
ENJFSUFFER * 1 
EXCEPTION oo 1 
FORMATERR * | 1 
LOSSOFCARRIER | * | 1 
LOSSOFOSR © * 1 
PARITY ~ * _ 1 
TIMEOUT | 4 * 1 
TRANERR | * | | 1 


USER TOGGLES: 
TOS C<INDEX>] } * 7 1 


LINE (TOG C<INDEX>])) * 1 
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VARIABL=: ASSIGNABLE: SIZE IN 
CYES=*) BITS: 


USER TAJLIES: 


TALLY E<INDEX>] & 8 
LIVE (TALLY C<ENDEX>)) * 8 
TIME (TALLY) | | #19 


STRING -UNCTIONS: 
CONVERT 


DECIMAL 


e=t2 
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SYSTEM STATUS VARIABLES 


SYNTAX: 


z= CHAR 

CHARACTER 
FREQUENCY CINPUT) 
FREQUENCY COUTPUT) 
IODESC 
INPUTATTACHED 
DUTPUTATTACHED 
LENGTH CINPUT) 
LENGTH COUTPUT) 
LINE 

LINE CCONTROL KEY) 
LINE CQUEUED) 
MAXSTATIONS 
RESULTDESC 

RETRY 

STATION 

STATION CENABLED) 
STATION CLINE) 
STATION (MYUSE) 
STATION CQUEUED) 
STATION CREADY) 
STATION (TYPE) 
TERMINALTYPE 

TIME 

TRAN CRECEIVE) 
TRAN (TRANSMIT) 


<SYSTEM STATUS VARIABLE> 


mm 2p ape Ge asp a Oe aw aw a om ewe leelUm le mel ee lee eel ee la 
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SEMANTICS: 


CHAR» C4ARACTER 


Both nanes refer to the same thing» the character register» a 
one-byt2 field in the Line table. Assignable» it ts intended to be 
used in REQUESTs while processtng a message character by character. 
The "FETCH" statement loads the register. For example: 


DO ECHOLOOP FOREVER. 
FETCH CHAR. - 
TRANSMIT CHAR. 
IF CHAR EQ ETX THEN UNDO. 
END ECHOLOOP. 


FREQUENT Y CINPUT)» FREQUENCY COUTPUT) 


These eight-bit read-only items tn the station table are accessible 
onty by CONTROLS and are declared by the user in the <FREQUENCY 
STATEMENT> in the STATION section. 
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TODESC 


288-bit read-only field in Line table. Accessible only in REQUESTS. 
IODESC contains the two 144-bit [1/0 descriptors used for I[/0 on the 
current tine. Useful in debugging» probably in <AUDIT STATEMENT. 


INPUTATTACHED 


One-bit flag in line tablee Not assignabler accessible only in 
REQUESTs~. INPUTATTACHED is set true if there is a valid input 
message buffer into which data may be received» false if no input 
message buffer is attached to the line. 


OUTPUTATTACHED 


One-bit flag in line table. Not assignable» accessible onty in 
REQUESTs-e OUTPUTATTACHED is set true if there is a valid output 
message buffer attached to the line for transmissions» false _ if 
there is no output message buffer attached. 


LENGTH CINPUT)» LENGTH COQUTPUT) 


Two 12-bit read-only fields in the Line table. Accessible onty in 
REQUESTs. The length in bytes of the input or output text 
respectively. It does not include the header length or ETX. 


LINE 


| Eight-bit item in tine table which stores the current line-number. 
-pead-onlys» accessible by both REQUESTS and CONTROLS. 
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LINE CCINTROL KEY) 


Five-bit» read-only item in tine table. This item is accessible only 
in cCONTROLs» and itt should be used to drive the “FLOW OF CONTRCL* 

in a SONTROL (See CONTROL SECTION)» probably as a CASE STATEMENT 

INDEX. The value of LINE CCONTROL KEY) gives the reason that the NC 

entered the CONTROL. To some extents» the value dictates the action 

that tha CONTROL should take. 


The Values: 
do. Line is not busy. [/0 may be tnitiated. 


1. Change in status of a station: or stations on 
this line. This occurs in the following cases: 


A) First time through CONTROL. 

B) Remote file open/close involving a station = on 
this line. 

Cc) NC EOJ initiated ~ all stations disabled _ for 
input. 

Dd TERMINATE ERROR has caused a statton to go not 
ready. 


The CONTROL should rebuild the poll List» if any (See 
Initiate Autopoll)» or retest the stations on the 
Line. If no stations are eligible for 1/05 the 
CONTROL should initiate idle. 


Ze An output message has been queued for this Lines but 
the line is now tn a read with no timeout or waiting 
for ring. CONTROL must resolve the conflict by: 


a) INITIATE CANCEL which kills the read» or 
b) CONTINUE Ahich leaves the read in progress and 
the output message in the queue. 


36 A ring complete has been received. Used for switched 
Lines only. mo 
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4e The last REQUEST on this line did a TERMINATE 
OUTPUTCRETURN). The CONTROL must restart it by 
eventually executing a CONTINUE. The CONTROL may at 
this point change the vatue of STATION before 
returning in some disciplines. 
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One-bit flag in Line table> read-only» accessible to CONTROLS~= and 
REQUESTse True if a message is queued for output for any station on 
this tine. 


MAXSTATIONS 


The maximum number of stations on the current’ Line, including 
passive stattonse read-only» accessible only in CONTROLs. Its value 
1s specified by the <MAXSTATIONS STATEMENT> tn the Line section. 
Normally used to test the current value of "STATION™ to see if it 
should ode reset to one: 


IF STATION EQ MAXSTATIONS 
THEN STATION?= 1. 
-ELSE STATION:=STATION+t1. 


RESULTDZSC 


48-bit read-only field accessible in REQUESTs. It consists of the 
24-bit result descriptors in the two I/0 descriptors kept for each 
Line in the tine table. RESULTDESC references subfields of 
*"TODESC™. Useful in debugging a datacomm system (Cas in “AUDIT 
TRACEFIZL CRESULTDESC).™) 


RETRY 


Eight=bit TALLY intended to be used to count receive or transmission 
retries .in REQUESTs. After each unsuccessful attempt» subtract one 

from R=ITRY. When RETRY equals zero» a TERMINATE ERROR’ would be 

appropriate. Assignable and accessible in both REQUESTs = and 

CONTROLs-»~ The initial vatue of retry is set by the <RETRY 

STATEMENT> tn the station section. It may be reset to this value at 

run-time oy INITIALIZE RETRY tn REQUESTs. CIt is never implicitly 

reinitialized by the NC). 
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STATION 


10-bit field in tine tables» assignable oy CONTROLs» eread-onty by 
REQUESTs. I[t contains the current station number on this” tine. 
STATION . must be greater than or equal to one» and it may never’ be 
greater than MAXSTATIONS. A fatal run error will occur if STATION 
exceeds these bounds» so the NDL programmer should always test the 
value of station before incrementing it~ (C€See MAXSTATIONSs also 
CONTROL section). STATION numbers are determined by the order of 
stations in the <LINE STATION STATEMENT> in the Line section. Note 
that STATION refers only to the line-relative station number. It is 
not the same as the “logical station number™ which appears in the 
2?-byte message header. “Logical station number” is untque to each 
station in the systeme regardless of which tine it is on» and is 
determined by the order tn which stations are declared in the 
station section. Neither is STATION the same as'the “filerelative 
station number™ which is used as a key by user programs in doing 
1/70 01 remote files. Neither “logical station number" nor 
"filecrelative station numder* are referenceable within NOL. 


STATION (MYUSE) 


22-bit» read-only item in the station table» accessible only in 
CONTROLs. Its value is assigned by the <MYUSE STATEMENT> in the 
station secttons» as follows: 


ks Station is input only. | 
Ze Station is output only. 
3e Station is used for input and output. 


The default value is 3. 


STATION CENABLED) 


Onesbit» read-onty flag in station table. Accessible by CONTROLs. 
"STATIUV CENABLED)™ must be true if I/0 is to be initiated by the 
CONTROL for this station (See CONTROL INITIATE STATEMENT)~ Set in 
the station section by <ENABLEINPUT STATEMENT>» but can be 
overridden by the MCS. © 
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STATIONCLINE ) 


Eight-pit» read-only entry in the station table ahich indicates the 
line index of the line currently associated with the station in a 
switched-lLine environment. Set when a line CONTROL does an initiate 
Cinput» outputs tnput-outputs» outputrinoput) and reset to zero on an 
initiat2 disconnect» terminate disconnects» or terminate release 
station. STASIONCLINE) should be used in a CONTROL to determine if 
a station is assigned to another tine or the current Line ors if 
zeror urassigned. 


STATION CQUEUED) 


One dite read-only. Accessible by both REQUESTs and CONTROLs. True 
if curre2nt station has at least one message in its output queue. I[f 
falser INITIATE OUTPUT ts invalid in CONTROLS for this station. 


STATION CREADY) 


Onesbit» readonly flag in station table. Accessible by CONTROLs. 
Must b2 true tn order to initiate I/0 in CONTROLS (CSee IF 
STATEMENT). Statton can be marked not ready by MCS. If an MCS is 
presents TERMINATE ERROR marks a station not ready. 


STATION CTYPE) 


Twotpit readeonly field accessible in both REQUESTs and CONTROLs. It 
represents the master/slave type of the remote device currently 


indexed by STATION. 


Possible values: 


1. Slave station 
fala Controller station 
Ss Normal station 


See the <CONTROLLER STATEMENT> tn the station section for 
information on setting this variable. STATION CTYPE) should be used 
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in building poll strings (See <POLL STATEMENT>) to take advantage 
of group poll. 


TERMINALTYPE 


Six*bit read-only field in terminal table. Value is set by’ the 
TERMINA. TYPE statement in the terminal section. 


TIME 


20-bit field giving the time of day in tenths of a second = since 
midnight. Invoking TIME at run-time loads the value directly from 
the system clock. Used to load TIME (TALLY) for message headers: 


TIME CTALLY) := Time. 


TRAN CRICEIVE)D 


Be 16s or 24 bit field kept in the station table to hold the 
transmission number of input messages. Assignable and accessible in 
REQUEST s. Normally loaded from the internat message header by 
RECEIVE TRAN. After RECEIVE TRAN» TRANERR will be set if this 
transmission number equals the last transmission number- Length is 
set in terminal section by <TRANSMISSION NUMBER STATEMENT>. Set to 
zero by "INITIALIZE TRAN CRECEIVE)"™. 
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TRAN CTRANSMIT) 


Output nessage transmission number. TRANCTRANSMIT) can be assigned 
directly in REQUESTs CTRANCTRANSMIT):= Decimal CTALLYCOJ» 3).) or 
set by the NC by specifying INITIALIZE TRANCTRANSMIT). At BOU timer 
TRANCTRANSMIT) is set to binary zeroes»s so it should be reset 
before sending ite Normally it should be given a value different 
from the value of the last output transmission numbers either by 
the REQJEST or by the MCS. Not referenceable tn CONTROLs. 
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ERROR FLAGS 


SYNTAX: 


<ERROR “LAG>2:= <RECEIVE ERROR FLAG> 
{ <TRANSMIT ERROR FLAG> 
{ <ITEM ERROR FLAG> 


<RECEIV= ERROR FLAG>::= PARITY 

| ACCESSERR 
TIMEOUT 

BREAK 
LOSSOFCARRIER 
EXCEPTION 


<TRANSMIT ERROR FLAG>: 3= BREAK 
{ LOSSOFDSR 
{ TIMEOUT 
{ EXCEPTION 


<ITEM E?%ROR FLAG>::= ADDERR 
{ TRANERR 
{ FORMATERR 
|! ENDOFBUFFER 


SEMANTICS: 


All error flags are one-bit fields» assignable and accessible in 
REQUESTs. ENDOFBUFFER ts the only error flag assignable and 
accessidie in CONTROLS too. All error flags are reset by the NC 
before initiating [/0- Each is automatically set: on the occurrence 
of the appropriate error state. In input REQUESTs the error’ flags 
are moved to the readterror field in the 27~-byte internal message 
header. | 
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ADDERR 


Set on input from a station when an error in the station address is 
detected. The size and vatue of the station address as defined in 
the <TERMINAL ADDRESS STATEMENT> and <STATION ADDRESS STATEMENT> 
allow the Network Controller to check the correct value against 


that which is received. 


ACCESSERR 


Set if the MLC/SLC was not granted memory access before the next 
Ccharact2r was received on the liner, destroying the previous 


character. 


BREA 


A BREAK signal was received from the remote station during output. 
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ENDOFBU-FER 


Set on & conditions: 
le In an input REQUEST» the number of characters 
stored in the buffer exceeds’ the maximum 
specified by the <MAXINPUT STATEMENT> in the 
terminal description. 
Ce In an output REQUEST» the transmit I/0 reached 
the end of the message without encountering a 
terminating character Ce.g. ACK» NAK» ENQe ETB> 
EOT» ETX for TC500). 
3e In input REQUEST» the number of FETCHed 
characters exceeded the number actually in the 
buffer. 
4e In a CONTROL» polt tist too long. 
EXCEPTIIN 


Set trie if parity» ACCESSERR»e ENDOFBUFFER» TIMEOUT, 
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BREAK» 


LOSSIFCARRIERs or LOSSOFDSR is set because of an initiated 1/0. 


FORMATERR 


Set if 
input 


an NDL REQUEST uses the RECEIVE <string> option 


- to check 


data» and the characters received do not correspond to the 
<string> specified. 
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LOSSOFCARRIER 


Set if hardware» specifically the data set» reported LOSSOFCARRIER 
frequency. 


LOSSOFISR> 


Set if hardware reports that data set ready was dropped during = an 


PARITY 


Set when parity error or BCC error is detected while receiving a 
message. 


TIME QUT 


A charaztter was not received Con input) or the first character was 
not transmitted within the time specified by the adapter. 


TRANERR 


After "2ECEIVE TRANCRECEIVE)", the transmission number received was 
equal t>» the number in the last message from the same station. 
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USER TOGGLES 


SYNTAX: 
<USER TIGGLE>::= TOGL<TOG INDEX>] 

1 LINECTOG CLTOG INDEX)) 
<TOG INJEX>::= <INTEGER> ¢ <VARIASLE> 


SEMANTIZS: 


TOG 


A variadle number of onesbit fields in the station table can be 
reserved for programmer use-e They are assignable and accessible by 
both RZQUESTs and CONTROLs» but are more useful to REQUESTs'= = since 
there is one set of TOGs for each statton. They must be set by 
either an <ASSIGNMENT STATEMENT> or by an <INITIALIZE STATEMENT>. 
TOGs are useful as local data or for communicating with the MCS. 
TOGLO"“7) are automaticatly loaded in the 27*byte internat header of 
any message queued for the MCS or user program Cincluding error 
messages: @ege "TERMINATE INPUT®™ or “TERMINATE ERROR™). TOGGLES can 
be reloaded from the header of an output message by INITIALIZE TOG 
C<INDEX>]. 
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LINECTOS) 


A variable number of assignable one-bit fields in the line 
be reserved for programmer use. Other than Locations Line 


are similar to station TOGGLES. 


RESTRICTIONS: 


1) A "MAX™ statement in the declaration section 
must preceed any TOGGLE indexed by a variable. 


2) No more than the absolute maximum of 100 Line 
TOGGLES and 100 station TOGGLES may be used. 


3) TOGGLE indices start at 0 and proceed 
sequentially. 


&) In the event a "MAX" statement ts not used the 
number of TOGGLES wittl be determined by the 
Largest index used. 


amet 


LANGUAGE 


tabte can 
TOGGLES 
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aoa TALLIES 


SYNTAX: 

<USER TALLY>2:= TALLY C<TALLY INDEX>] 
1! LINE CTALLY C<TALLY INDEX>]) 
1 TIMECTALLY) 

<TALLY INDEX>::= <INTEGER> 1 <VARIABLE> 


SEMANTICS: 


A variazsle number of eight-bit fields in the station table which can 
be resarved for programmer use. AsSignable and accessible in both 

REQUCSTs and CONTROLs. They must be set by either an <ASSIGNMENT 

STATEMENT> or an <INITIALIZE STATEMENT>. Useful as tocal data or 

MCS communication CTALLY{0~2] witl be transported in the 27~byte 

internal header). 


LINECTALLY) 


A variable number of eitght-bit fields in the Line table which can be 
reserved for programmer use. ASSignable and accessible to both 


REQUESTs and CONTROLSs.- 


TIMECTALLY) 


20-bit field in station tables assignable and accessible only in 
REQUESTS. Normally assigned the vatue of "TIME" in input REQUESTs. 
Moved by the NC to the internal message header on a "RECEIVE TEXT®™. 


TIMECTALLY) is subject to the same restrictions as user TALLIES. 
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STRING FUNCTIONS 


SYNTAX: 
<STRING FUNCTION>?3 := <DECIMAL FUNCTION> 
1 <CONVERT FUNCTION> 
<DECIMAL FUNCTION>:2=. DECIMAL CK<EXPRESSION>» <INTEGER>) 
<CONVERT FUNCTION?>::= CONVERT C<EXPRESSION>) 


{ CONVERT C<EXPRESSION>»1) 


SEMANTICS: 


The <DECIMAL FUNCTION> is identical to the SOL/UPL “DECIMAL”. It 
converts the value of the <EXPRESSION>, treated as a binary number» 
to an =BCDIC string of decimat digits of tength <integer>. For 
example» DECIMAL C4"FF%, 3) is converted to the string "255"» or 
4"F2FSF5". DECIMAL returns a maximum of eight characters even § if 
the value of <integer> is greater. If the value of the <expression> 
exceeds 24 bits only the lowrorder 24 bits is used. 


The <CONVERT FUNCTION> converts binary strings of any length to 
character strings. If "+1" is specified. then one character is 


generat2d for each bit ("0" for binary O» "1" for binary 1). The 
default is 4 bits to one character CHexadecimal conversion). 
Leading zeroes will be supplied to fill out leftmost Hexadecimal 


positionss if necessary. For example: 
1) CONVERT €255-1) = *000900000000000011111111" 


2) CONVERT €255) = "OOOOFF™ 
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EXPRESSIONS 
SYNTAX: 
<EXPRESSION>::= <TERM> 


1 <TERM> <BINARY OPERATOR> <EXPRESSION> 
1 <EXPRESSION> <BINARY OPERATOR> <TERM> 


<TERM>s2= <PRIMARY> 
1 <UNARY OPERATOR> <PRIMARY> 


<PRIMARY>3: 25 (<EXPRESSION>) 
<VARTABLE> 
<CONSTANT IDENTIFIER> 
<STRING> 

<INTEGER> 

<LOGICAL VALUE> 


<CONSTANT IDENTIFIER>: := (SEE CONSTANT DECLARATION) 


SEMANTICS: 


Expresstons are used in the REQUEST and CONTROL sections in vartous 
statements. Note that no distinction is made between logical and 
arithmetic expressions. Since REQUEST and CONTROL code is executed 
on the SDL“Machines» expressions like ; 


(TRUE + 10 NE DISCONNECT) * TALLYO] 


are syntactically legal and will execute without run-time errors. 
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OPERATO®% PRECEDENCE: 


If there are no parentheses to guide evaluation of an expression (as 
in "TRJE + 10 NE DISCONNECT)» operator precedence determines’ the 

order of evaluation. Two rules are used: (1) equal precedence 

operators are evaluated from left to rights» and (2) higher 

precedence overators are evaluated first. From highest to lowest» 

the precedence order is: 


unary t+» unary-(equal precedence) 

t» <SLASH> 

binary +» binary- 

LT» LE» EQ» NE» GT» GE» =» <» > 
NOT 

AND 

OR | 

For exanple "TRUE + 10 NE DISCONNECT * 3" is evaluated as if it had 


been written "CTRUE + 10) NE CDISCONNECT «*« 3)* 


EXPRESSION VALUc LENGTH: 


If no binary operator was used» the length of the value left on the 
value stack after expression evaluation ts equal to the Length of 
the primary Ciee. 24 bits for <integer>» 1 bit for "TRUE", etc). 
Logical binary operators CAND» OR) return vatues whose length is 
equal to the longer of the two operandss arithmetic operators 
return 24-bit values. 
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SECTIONS OF AN NOL PROGRAM 


SYNTAX: 


<NETWORY DESCRIPTION>:3= <DECLARATION SECTION> 
. <REQUEST SECTION> 
<LINE CONTROL SECTION> 
<TERMINAL SECTION> 
<STATION SECTION> 
<LINE SECTION? 
<FILE SECTION> 


SEMANTICS: 


The sections of an NOL program must appear in the above order. Atl 
sections are required. 
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DECLARATION SECTION 


SYNTAX: 
<DECLARATION SECTION>:3:= DECLARATION: <ONECLARATION LIST> 
<DECLARATION LIST>s:= <DECLARATION> 
§ <DECLARATION LIST> <DECLARATION> 
{1 <EMPTY>. 
<DECLARATION>: := <SIGNAL DECLARATION> 
1 <AUDITFILE DECLARATION> 
{| <CONSTANT DECLARATION> 
1 <NIF NAME DECLARATION> 
1 <MAX TALLY/TOG DECLARATION> 
SEMANTICS: 


The declaration section provides a means of specifying global 
definitions for the user's Network Controlter. 


SIGNAL DECLARATION 


SYNTAX: 

<SIGNAL DECLARATION>::= SIGNAL = "<SIGNAL CHARACTER STRING>". 
<SIGNAL 

‘CHARACTIR STRING> 2 sH= <EBCDIC CHARACTER> 


1 <EBCDIC CHARACTER> <EBCDIC CHARACTER> 
{ <EBCDIC CHARACTER> <EBCDIC CHARACTER> 


<EBCDIC CHARACTER> 
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SEMANTICS: 


Signat defines up to three one-character prefixes to be used in 
Station-To-Station MCS communication. Any messages that have text 
beginning with one of the signal characters are queued 
automatically by the NC for the MCS. This is true even if the MCS 
has chosen not to participate in user program-remote file I/Q0» and 
this station 15s in the remote file. 
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AUDLTFILE DECLARATION. 


SYNTAX: 


<AUDITFILE DECLARATION>: 2= AUDITFILE <AUDITFILE IDENTIFIER> 


C<FILE ATTRIBUTE LIST>). 


<FILE ATTRIBUTE LIST>3:= <FILE ATTRIBUTE> 


{ <FILE ATTRIBUTE>» <FILE ATTRIBUTE LIST> 


<FILE ATTRIBUTES := <LABEL PART> 


<DEVICE PART> 
<BUFFERS PART> 
<VARIABLE PART> 
<SAVE PART> 
<RECORDS PART> 
<AREAS PART> 
<EMPTY> 


<LAZEL PART>::= LABEL = <FILE NAME> 


<FILE NAME>s2= <FAMILY“ID> 
1 <FAMILY~I0> <SLASH> <FILE=-ID> 
1 <FAMILY“ID> <SLASH> <FILE-ID> <SLASH> 
1 <PACK“ID> <SLASH> <FAMILY~ID> 
<SLASH> <FILE-ID> 


<FILETID>» <FAMILY- 
ID>» <PACK=ID>::= <EBCDIC STRING> 


NOTE = 10 CHARACTER MAXIMUM ON EACH ID. 
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Be <DEVICE PART>::= 


<DEVICE SPECIFIER>::= 


Ce. <sUTFERS PART>33= 


D. <VARIABLE PART>::= 


COMPANY CON 
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DEVICE = <DEVICE 


PRINTER OR BACKU 
PRINTER BACKUP 


DISK ( 
1 DISKFILE ( 
! DISKPACK ¢ 
{ DISKCARTRIDGE ¢ 
{ TAPE C 
! TAPE? ¢ 
1 TAPEY ( 
1 TAPEPE ¢ 
{ PRINTER 
j 
1 


ace 5 


SPECIFIER> 


ANY DISK) 

HEAD PER TRACK) 
CENTURY~TYPE) 
CAELUS“TYPE) 
ANY TAPE) 
7-TRACK) 
9-TRACK) 
PHASE*ENCLOSED) 


P 


BUFFERS = <INTEGER> 


VARIABLE 


NOTE = VARIABLE~LENGTH RECORDS 


Es <SAVE PART>:2= 
~ NOTE = NUMBER DAYS TO 


Fe <RECORDS PART>3:= 
<RETSORD SPECIFIER>s3:= 
<RECORD LENGTH>2:= 
<BLICK LENGTH>:s:= 
NOT= = LENGTHS ARE [IN 

Ge <ARZAS PART>33= 


<NUYBER AREAS>33= 
<BLICKS PER AREA>:2= 


NOT= = DISK FILES ONLY 


SAVE = <INTEGER> 
SAVE FILE 


RECORDS = <RECORD SPECIFIER> 


<RECCRD LENGTH> 
{1 <RECORD LENGTH> 


<INTEGER> 
<INTEGER> 
BYTES. 


AREAS = <NUMBER 
<SLASH> <BLOCKS 


<INTEGER> 
<INTEGER> 


<SLASH> <BLOCK LENGTH> 


AREAS> 
PER AREA> 
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Auditfites are used in <AUDIT STATEMENT>s in the REQUEST section. A 
maximum of three auditfiles may be declared. Any auditfile may be 
referenced in any REQUEST. As far as the MCP is concerned» 
auditfiles are simple sequential files opened output by the user's 
NC. AS Such they may be modified at BOJ time by means of label 
equation ("?FILE" cards). The internat file name is the <AUDITFILE 
IDENTIFIER>. Default file attributes are device = disk» labet = 
<AUDITFILE IDENTIFIER>, buffers = 1 Cunbuffered I/0 is impossible 
under M2P control)» fixed-length records» save = 30 days. If device 
type is disk then records = 180/11» areas = 40/100 (4000 record 
maximum). af device type is TAPE» RECOROS = 180/1~. If device type 
is PRINTER» RECORDS = 132/11. The Lock bit in the FPB is set to 
ensure "CLOSE WITH LOCK™ if the NC 1s DS'*'ed. 


EXAMPLES: 


AUJITFILE AUDITOISK CDEVICE = DISKCARTRIDGE» 


LABEL = “PACKNAME"™/™MYFAMILY™/"MYF ILE "se 
BUFFERS = 2» VARIABLE» SAVE = 7» 
RECORDS = 130/10» AREAS = 1/1000). 


AUJITFILE DEFAULT C€ ). 


AUJITFILE AUDITTAPE COEVICE = TAPE» LABEL = “"AUDITFILE"/™A™> 
RECOROS = 1380/1). 


AUJITFILE PRNTR CDEVICE = PRINTER). 
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CONSTANT DECLARATION 


SYNTAX: 


<CONSTANT DECLARATION>::= CONSTANT <CONSTANT DEFINITION LIST>. 


<CONSTANT DEFINITION 
LIST>s:= <CONSTANT DEF INITION> 
ft <CONSTANT DEF INITION>» <CONSTANT 
DEFINITION LIST> 


<CONSTANT DEFINITION>:<:= <CONSTANT IDENTIFIER>=<STRING> 


<CONSTANT [DENTIFIER>23= <IDENTIFIER> 


SEMANTICS: 


Constant declaration provides a means of equating identifiers with 
strings. Subsequent references» occurrences of the identifier cause 
the conpiler to substitute the equated string» This is useful for 
frequently used strings such as controt characters» or common 
concatenations of control characters (Cieee CONSTANT CRLF= 4 
"0D250000" for "CARRIAGE RETURN“LINEFEED). Common control 
Charact2rs have been defined witnin the conpiler by default to the 
following Hexadecimal values: 


ACK = 2E EOT = = 00 
BEL = 2F ESC = 27 POL = 97 
CAN = 18 ETB = 26 RS = i1E 
CR = OD ETX = 03 SI = OF 
0C1l1 = 11 FF = OC SEL = 98 
OC2 = 12 FS = 1C 30 = OE 
0C3 = 13 FSL. = A2 SOH = O1 
0C4 = 3C GS = 1D STX = 02 
JEL = OF HT = 05 SYN = 32 
DLE = 10 LF = 25 US = dF 
ENQ = 20 NAK = 30 VT = OB 
FS = 1C 


These identifiers may be redefined to other stringse but may not be 
used as non-constant identifiers. 
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EXAMPLES OF CONSTANTS: 
I. Vatid 
CONSTANT NUL = 4°00">» 
BADL = "ERROR"™>» 
RETRANSMIT = "PLEASE SEND AGAIN". 
CONSTANT QUOTE = ""MR, 


II. Invalid 


CONSTANT I2KANGAROO = X IDENTIFIER MUST BEGIN WITH LETTER. 
12. % not a string. 
CONSTANT CLEAR = Z RESERVED WORD MAY NOT 
2 BE USED AS CONSTANT 
4"000"7. = % 


MALFORMED STRING. 
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NIF NAME DECLARATION 


SYNTAX: 


<NIF NAYE DECLARATION>::= NIF = <FILE NAME>. 


aol mi Rie 33 


The name specified is substututed in the NIF FP8 and in the object 
filets ?P8 for the default name “NOL“/"NIF™. 


MAX VALE PeICG DECLARATIIN 


MAX TAL. Y/T0G 

DECLARATION>::= MAX TALLY CEC <INTEGER> ] . 
{ MAX LINE (€ TALLY € <INTEGER> ] ) . 
( MAX TOG C <INTEGER> ] . 
i MAX LINE € TOG € <INTEGER> 1). 


SEMANTICS: 


The int2ger specifies the Largest allowable TALLY or TOGGLE and 
Limits the TALLY or TOGGLE section of the line or station table. 


REST LE LGNSs 


1) No more than 100 TALLIES or TOGGLES may be 
declared» making the largest index 99. 


2) If the declared maximum ts exceeded by an 
integer subscript» a warning will result and the 
maximum will be tncreased. 
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REQUEST SECTION 


SYNTAX: 


<REQUEST SECTION>::= 


<REQUEST LIST>:3= 
<REQUEST>: 


<REQUEST STATEMENT LIST>:3= 


<REQUEST STATEMENT >= 2= 
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<REQUEST LIST> 


<REQUEST> <REQUEST LIST> 
<REQUEST> 


REQUEST <IDENTIFIER>: 
<REQUEST STATEMENT LIST> 


<REQUEST STATEMENT> 
<REQUEST STATEMENT>. 


<REQUEST STATEMENT LIST> 


<ASSIGNMENT STATEMENT > 
<AUDIT STATEMENT> 
<CASE STATEMENT> 
<DISPLAY STATEMENT> 
<DO STATEMENT> 

<FETCH STATEMENT> 
<FINISH STATEMENT> 

<IF STATEMENT> 
<INITIALIZE STATEMENT> 
<INITIATE STATEMENT> 
<NULL STATEMENT> 
<RECEIVE STATEMENT> 
<TERMINATE STATEMENT> 
<TRANSMIT STATEMENT> 
<UNDO STATEMENT> 
<INCREMENT STATEMENT> 
<DECREMENT STATEMENT> 


aa | 
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SEMANTICS: 


The REQJEST section is a series of tine discipline routines 
CREQUESTs) which are used oy the Network Controller in 
Communicating with the various remote devices. A REQUEST must be 
defined for each terminal. If it is possible for a terminal to send 
input to the system and receive output from the system then both a 
receive and transmit REQUEST must be defined for that terminal. The 
REQUEST to be used for each of these conditions is specified by the 
terminal's <REQUEST STATEMENT> as discussed in the terminal section 
of this product specification. 


REQUESTS are treated as I[/0 coroutines by the network CONTROLter. 
For instancer when a Line CONTROL desires to output a message to a 
TC0500- the NC selects the correct transmit REQUEST from the 1TC500 
terminal definition and gives it CGONTROL-~ The . TC500 transmit 
REQUEST executes the tine discipline until the I[/0 is successful or 
until it detects a serious errors at which point the NC regains 
Control. The REQUEST wilt also yield controt to the NC while 
hardware I/9 is in progress for the TC500 station. During this time 
the NC can process other Lines or yield to the MCPr until the I[/9 
is comaiete- Thus the NC can handle severat datacomm I/O processes 
concurrently. Concurrency is transparent to the REQUEST» however. 
REQUESTs are coded as if I/0 were instantaneous. 


Four RZQUEST statements are concerned with transfer of control a 
"D0", “UNDO%» “CASE*%» and "IF". NOL has no "GO TO". There is no 
means of declaring subroutines for a REQUEST» nor may the 
programner declare tocalt variables beyond those defined in the 
variables section. : 


REQUESTs are Linked to specific terminals by referencing the REQUEST 
identifier in the <TERMINAL REQUEST STATEMENT> in the terminal 

section. REQUESTs are reentrantsr so two stations using the same 

REQUcCST may be handled concurrently on-different lines. 
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ASSIGNMENT STATEMENT 


SYNTAX: 


<ASSIGNYENT STATEMENT>::= 


<ASSIGNABLE VARTABLE>: 


SEMANTICS: 


The <ASSIGNMENT STATEMENT> 
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<ASSIGNABLE VARIABLE> 
<ASSIGNER> <EXPRESSION>. 


CSEE VARIABLES) 


is the means by which an NODL 


changes the value of an assignable variable. Examples: 


TALLY COJ2=TALLY C1] * 3. 
TOG £117:=EXCEPTION OR LINE CTOG (0)?). 


TIME CTALLY):=TIME. 


a7 3 


LANGUAGE 


REQUEST 
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AUDIT STATEMENT 


SYNTAX: 


<AUDIT STATEMENT>33= AUDIT <AUDITFILE [D0ENTIFIER> 
C<AUDIT ELEMENT LIST>). 


<AUDIT ZLEMENT LIST>3:= <MESSAGE> 

<EXPRESSTON LIST> 

<EXPRESSION LIST>» <MESSAGE> 
<MESSAGE>» <EXPRESSION LIST> 
<EXPRESSION LIST>» <MESSAGE >» 
<EXPRESSION LIST> 


ao = aw ee 


<AUDITFILE IDENTIFIER>32:= CSEE <AUDITFILE DECLARATION 
STATEMENT> IN DECLARATION SECTION) 


<MESSAG=I>3 3= BUFFER C<MESSAGE MODIFIER>) 
§ TEXT C<MESSAGE MODIFIER>) 
1 WORKAREA C<MESSAGE MODIFIER>) 


<MESSAG: MODIFIER>::= <I0> 
1 <10>» <INTEGER> 


<[O0>233s= INPUT 
{ OUTPUT 


EXPRESSION LIST>:2= <EXPRESSION> 
1 <EXPRESSION>» <EXPRESSION LIST> 
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SEMANTICS: 


The audit statement is a write to a userwdeclared file. The data to 
be written ts the <AUDIT ELEMENT LIST>» formed by concatenating the 
specifi2zd combination of <MESSAGE> and <EXPRESSION LIST>s.~ If the 
concatenated string is shorter than the auditfile record length» 
rightmost blanks wilt be added; if longer» rightmost truncation 
Will occur. See DECLARATION SECTION for the auditfite dectaration 
format. 


<MESSAG=> breaks down as follows: 
le "TEXT" = message excluding the header 


Ze "BUFFER™ = message including the entire 27-byte 
header. 


3. "WORKAREA™ = terminal header workareas» tength as 
in <HEADER SIZE STATEMENT> in terminal section. 


<INTEGE?> option in the message modifier tells the NC how many 
characters of the <MESSAGE> to audit. For examples this statement 
writes the first 10 characters of the text to FILEA: 


AUDIT FILEA (TEXT CINPUT» 10)). 


The default value for <INTEGER> tis Or indicating ‘that the entire 
message (up to the auditfile record size) is to be written. 


<EXPRESSION LIST> may be included before or after or without 
<MESSAG= >. The fields resulting from evaluation of each expression 
are concatenated in the order specified. (See EXPRESSIONS for’ the 
length of expression values). The string functions» "DECIMAL" and 
W"CONVERT"™» are useful here to change TALLIES» TOGGLES» and flags to 
easily-orintable format. [his example results in a 36"character 
string sonsisting of “TALLY 1 = nnn» INPUT = ttttetttte THATS ALL": 


AUDIT FILEA C™TALLY 1 ="» DECIMAL (TALLY C1l]>» 3)5 “» INPUT="> 
TEXT CINPUT>» 10)5 "THATS ALL"). 
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CAS= STATEMENT 


SYNTAX: 

<CASE STATEMENT>? 2= <CASE HEAD> <CASE BODY> 

<CASE HiAD>: 3 CASE <EXPRESSION>. 

<CASE 3IDY>:2= <REQUEST STATEMENT LIST> 
<CASE ENDING> 

<CASE ENDING>::= ENO CASE. 


SEMANTISS: 


The <EX?RESSION> serves as an tndex tnto the tist of <REQUEST 
STATEMENT> Ss» the statement selected is executed» and the others 
ignored. Control is then transferred to the statement following the 
<CASE ENDING> unless the statement is an "UNDO". 


of <EXPRESSION> are from 0 through Nel. 
The statements in the List may be any tegat <REQUEST STATEMENT> 


allowed in NOL- [If the user wishes to execute nothing for a_ given 
value of <EXPRESSION>» the <NULL STATEMENT> is appropriate. 
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DECZEMENT STATEMENT 


SYNTAX? 
<DECREMZNT STATEMENT>3: 3= DECREMENT FRAN C<TRAN MODIFIER>). 
<TRAN MIDIFIER>s 2= TRANSMIT 
| RECEIVE 
SEMANTI2S: 


The Decrement Statement decreases the value of an EBCDIC Decimal 
encoded transmission number by 1. It is intended to be used in 
systems where the MCS does not set output transmission numbers. 


TRAN MOOTFIER: | 

TRAN CT-RANSMIT) = OUTPUT TRANSMISSION NUMBER. 

TRAN CRECEIVE) - INPUT TRANSMISSION NUMBER. 
Example: The Sfancneseion number of the last output message was 
"360". ODECREMENT TRAN CTRANSMIT) will decrease the value to "379" 


(Hexadecimal F3F7F9). The field wilt be set to att "9"5 on 
underflow. 
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DIS?7LAY STATEMENT 


SYNTAX: 


<DISPLAY STATEMENT>::= 


<EXPRESSION LIST>:s= 


SEMANTICS: 


Display puts a Character 
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DISPLAY <EXPRESSION LIST>. 


<EXPRESSTON> 
f <EXPRESSION>» <EXPRESSION LIST> 


string out to the SPO via a communicate. 
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DD STATEMENT 


SYNTAX: 
<DO STATEMENT>:2= 


<D00O HEAD>ss= 


<END PART>235 


<IDENTIF IER PART>23= 
<FOREVER PART>23= 
<D0 IDENTIFIER>::= 


SEMANTICS: 


arg 
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<DU HEAD> <REQUEST STATEMENT 
LIST> <END PART> 


DO <IDENTIFIER PART> 
<FOREVER PART>. 


END <INDENTIFIER PART>. 


<DD IDENTIFIER> 
<EMPTY> 


FOREVER 
<EMPTY> 


<IDENTIFIER> 


The DO Statement provides a means of grouping two or more REQUEST 
statements Cincluding other <DO STATEMENT>s) as one statement. This 
is useful in <IF STATEMENT>sS and <CASE STATEMENT>s. DO Statements 
may be nested. The DO~Identifier is optional. Exampte: 


IF TOGC1] THEN 


°O00 OUTER. 


DO INNER FOREVER. 


FETCH CHARACTER. 
IF CHAR EQ ETX THEN UNDO INNER. 


END INNER. 
TALLY (13 
END QOUTER. 


TALLY C1] * Le. 


FOREVER forces the <REQUEST STATEMENT LIST> to be repeated until an 
UNDU or a TERMINATE ts encountered. 
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RESTRICTIONS: 


Le {tf a <DO IDENTIFIER> is included in the <00. 
HEAD>» it must also appear in the <END PART>. 


Ze If the <D0 HEAD> does not tnclude an identifier. 
The <END PART> must not contain one. 


BURROUGHS CORPORATION 
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FETSH STATEMENT 


SYNTAX: 

<FETCH STATEMENT>3:2= 
<POINTE? ADVANCE PART>2:3= 
<FETCH JBJECT>3:= 


SEMANTICS: 


FETCH is only used in processing 
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FETCH <POINTER ADVANCE PART> 
<FETCH OBJECT>. 


OULI<EMPTY> 


CHAR 
CHARACTER 
<EMPTY> 


input. Before using FETCHe an 


"INITIATE RECEIVE" should be executed. Alt <FETCH OBJECT>s have the 


same 
char act er 


meaning ~ FETCH always loads the character register with the 
in the input message addressed by the message 


potntere 


The message pointer ts advanced by 1 character after the FETCH if 
the <POINTER ADVANCE PART> is 1 or <EMPTY>. A zero <POINTER ADVANCE 


PART> 


leaves the message pointer unchanged» so a subsequent 


FETCH 


or receive accesses the same characters N.B.? "ENDOFBUFFER™ will be 


set if the FETCH is executed with the message pointer set 


bey ond 


the Last character in the buffer. 
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FINISH STATEMENT 


SYNTAX: 
<FINISH STATEMENT>=33= FINISH TRANSMIT <TRANSMIT 
PART>“<TRANSMIT"RECEIVE PART>. 
< TRANSMIT PART>3s:= C<TRANSMIT LIST>] 
<TRANSMIT LIST>23= <TRANSMIT ATTRIBUTE> 
: { <TRANSMIT ATTRIBUTE >- <TRANSMIT LIST> 
<TRANSMIT ATTRIBUTE>*2= <TRANSMIT BASIC ATTRIBUTE> 


{ NO <TRANSMIT BASIC ATTRIBUTE> ~ 


<TRANSMIT BASIC 


ATTRIBUTE>:2= EOT 1 CR I TRANSLATE 
<TRANSMIT-RECEIVE 

PART>it= INITIATE RECEIVE <RECEIVE PART> 
<RECELVE PART>i:= (SEE INITIATE RECEIVE). 


SEMANTICS: 


WFINISH TRANSMIT" causes transmission of the output message 
constructed by a series of <TRANSMIT STATEMENT>s.: "FINISH TRANSMIT 
- INITIATE RECEIVE" tLinks to the transmit [/0 descriptor a receive 
1/0 descriptor which the hardware executes if the transmit 
complet2?s without error. (A Write-Flip~To-Read Operation). 


The <TRANSMIT BASIC ATTRIBUTE>s set variants in the hardware I/0 
descriptors they are Instructions to the 81700 Datacomm Hardware. 


EQT : EIT is to be treated as a control character. 
CR =: CR is to be treated as a control character (teletype adapter only). 
TRANSLATE 3 Transtate EBCOIC to ASCII. 


DEFAULTS : Translate» EOT» no CR 
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IF STATEMENT 


SYNTAX: 

<IF STATEMENT>s3= IF <EXPRESSION> THEN <REQUEST STATEMENT> 
<ELSE PART>. 

<ELSE PART> 3s ELSE <REQUEST STATEMENT> 


1 <EMPTY> 


The <EX?7RESSION> is evaluated» and the statement. following the 
"THEN” is executed if the least significant pit of the vatue is 
equal to one (true). If the bit ts off (false) the "ELSE" statement 
Cif pr2asent) is executed. [n all cases» controt passes to the 
statement following the IF statement. Any <REQUEST STATEMENT> igs 
legal after "THEN" and “ELSE™ including <IF STATEMENT>s» <NULL 
STATEMENT>s» and <DO STATEMENT>s- Example: 


IF CHAR NE ACK 
THEN DO» RECEIVE ADDRESS CRECEIVE). 
IF AODERR 
THEN TERMINATE ERROR. % NO "ELSE™ 
END. 
ELSE INITIATE RECEIVE. 
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INCREMENT STATEMENT 


SYNTAX: 
<INCREMZENT STATEMENT>3 2= INCREMENT TRAN C<TRAN MODIFIER>) 
<TRAN MIDIFIER>: 25 TRANSMIT 
. { RECEIVE 
SEMANTICS: 


The increment statement provides a means of changing the vatue of an 
EBCDIC encoded transmission number by 1. It ts intended to be used 
with output transmission numbers in systems where the MCS does not 
maintain the numbers. 


TRAN MODIFIER: 
TRAN CTRANSMIT) = OUTPUT TRANSMISSION NUMBER 
TRAN CRECELVE) - INPUT TRANSMISSION NUMBER 


Example: The output transmission number of the last message was 
7319" 6 "INCREMENT TRAN’ CTRANSMIT)." wilt bump the value to %380" 
Cin Hexadecimal notation: F3F8F0). The field witl be set to 
Character zeroes on overflow. 


5715 


BURRJUGIS CORPORATION COMPANY CONFIDENTIAL 
COMPUTER SYSTEMS GROUP B1700 NETWORK DEFINITION LANGUAGE 
SANTA BARBARA PLANT PeSe 2212 5223 


INITIALIZE STATEMENT 


SYNTAX: 


<INITIALIZE STATEMENT>3::= INITIALIZE <I TEM LIST> 
<ITEM LIST>23= <ITEM> 
: 1 <ITEM>,». <ITEM LIST>. 

CITEM>s3= TEXT 

{f TRAN CRECEIVE) 

1 TRAN CTRANSMIT) 

{1 TALLY (C<TALLY INDEX] 

1 TOG (€<TOG INDEX> J 

1 RETRY 
SEMANTI2S: 


WINITIA_-IZE TEXT™ sets the input message pointer in the NC to’ the 
first odyte of the input buffer Cincluding the terminal header). [t 
is done automatically by ae RECEIVE" and by ae successful 
completion of autopoll. 


WINITIAL-IZE TRAN CRECEIVE)™ resets the station input transmission 
number to binary zeroes. 


WINITIALIZE TRAN CTRANSMIT)™ sets the station output transmission 
number from the output external message header tf a message is 
attached» otherwise to character zeroes. 


"INITIALIZE <TALLY/TOGGLE>™ sets the listed TALLYS and TOGGLES from 
the itnternat 27-byte message header if there is ones» else to zero. 


"INITIALIZE RETRY*™ resets retry to its starting value (See <RETRY 
STATEMENT> in STATION section). 
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INITIATE STATEMENT 


SYNTAX: 


<INITIATE STATEMENT: s= INITIATE <INITIATE ACTION> 
<INITIATE ACTION>::= RECEIVE <RECEIVE PART> 
1 TRANSMIT 
<RECEIV= PART>:2= <EMPTY> 
-f C<RECEIVE LIST>) 
<RECEIV: LIST>:s5 <RECEIVE ATTRISUTE> 
1 <RECEIVE AFTRIBUTE>» <RECEIVE LIST> 
<RECEIVE ATTRIBUTE>: 2= <RECEIVE BASIC ATTRIBUTE> 


1} NO <RECEIVE BASIC ATTRIBUTE> 


<RECEIVeE BASTC . 
ATTRIBUTE>2s:= CONTROL 
TRANSLATE 
TIMEOUT 
EOT 

CR 

PARITY 
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SEMANTICS: 


The INITIATE RECEIVE form of the <INITIATE STATEMENT> commands’ the 
adapter (i.e. eLINE) to accept tnput. 


INITIAT= TRANSMIT sets the output message pointer to the first byte 
in the dsutput message buffer» 


CONTROL implies that the data will be input into the line input 
CONTROL workarea as opposed to the input buffer. 


TRANSLATE attribute causes hardware translation of data received. 
TIMEOUT attribute enables the receive timeout timer. 
E0T causes the adapter to treat EOT as a CONTROL character. 


CR (Cteletype adapter only) causes the adapter to treat CR as a 
CONTROL character. 


PARITY (Cteletype adapter only) causes parity checking of each 
Character. Parity checking on other adapters will not be affected 
by this option. 


DEFAULTS: TIMEOUT» TRANSLATE» E0T» NO CRe NO CONTROL» NO PARITY. 
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NUL. STATEMENT 


SYNTAX: 


<NULL STATEMENT>:3= <EMPTY>. 


SEMANTICS: 


The NULL statement may be used tn an IF or CASE where an executable 
statement is required but a NO“OP is desired. Example: 


CASE TALLYC3]. 
IF TOG ©€3] THEN. % NULL 


ELSE INITIATE INPUT. 
e & NULL 
DO. 
<REQUEST STATEMENT LIST> 
END. 
EN) CASE. 


Note that the case contains three executable statements» an IFf> a 
NULL» and aoODO. If TALLY £0] is equat to 1 entering the case» the 
NULL path is taken and the case 13 exited immediately. If TALLY £9] 
is equal to O» the if path is taken. If the THEN branch is’ taken» 
this NULL also results in exit from the case. 
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SYNTAX: 


CRECEIVE STATEMENT>22= RECEIVE <ITEM LIST>. 
<ITEM LIST>::5 <ITEM> 

1 <ITEM>» <ITEM LIST> 
<ITEM>22= ADORESS <ADORESS QUALIFIER> 

1 TEXT 

1 <STRING> 

| <CONSTANT> 

| TRAN <TRAN QUALIFIER> 
<ADORESS QUALIFIER>:?= (RECEIVE) 

| CTRANSMIT) 

I (STATION) 
<TRAN QJALIFIER>22= (RECEIVE) 

t CTRANSMIT) 

| <EMPTY> 
SEMANTICS: 


The rec2ive statement is used in input REQUESTs following an 
"INITIATE RECEIVE". Starting with the current setting of the input 
message pointers each item in the <ITEM LIST> is tested against the 
corresponding field in the input message. If they do not agrees the 
appropriate <ERROR FLAG> is set. Items are as follows: 


ADDRESS 


“ ADDRESS CRECEIVE)/S ADDRESS CTRANSMIT) refer to the strings specified 
in the stationts <STATION ADDRESS STATEMENT> (See STATION Section). 
If the address in the input message does not agree with the 
specified address» "ADDERR™ its set. 
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ADDRESS (STATION) 


The address field in the message witkh be compared against’ the 
receive addresses of all stattons on the current Line. If no match 
is founds» ADDERR is set. If a match is founds the station index is 
reset to the matching station (n.be This has serious implications 
for RZQUEST coding ~ all the variables that are station-specific 
are now different. For instancer TALLY (€0°2] and TOG (C0-7] 
reference entirely different fields after a successful RECEIVE 
ADDRESS CSTATION)). ADDRESS CSTATION) provides the REQUEST writer 
with a means of implementing. group poll» contention» and RJE tine 
disciplines» since this is the onty NDL language construct that 
permits a REQUEST to change station index at run time and respond 
to any of a set of stations which may have originated the current 


messag@e 


TEXT 


The input message pointer is set to the last character in the 
messager on the assumption that a terminating character follows. If 
more characters were received than specified in the station's 
<MAXINP JT STATEMENT>» ENOOFBUFFER is set. Note: A run error witlt 
result if RECEIVE TEXT is executed after INITIATE RECEIVE 
(CONTRO). 


FORMATERR is set if the corresponding characters don't agree. 
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TRAN 


TRAN CRECEIVE) “7 TRAN CTRANSMIT) refer to the transmission numbers 
of the last input/output message» respectively. If the characters 
in the input message are equal to the referenced last transmission 
numbers TRANERR ts sete Tran <EMPT Y> 1s equivalent to 
TRANCRECEIVE). 


Example: [f a certain terminal uses this input format-~ SOH» ADDRESS> 
TRANSMISSION NUMBER» STX» TEXT» ETX = then it may be checked with 
this receive series: 


RECEIVE SOH+ ADDRESS» STX» TEXT>» ETX. 
IF FORMATERR THEN UNDO. 

RECEIVE ADDRESS CRECEIVE)s» TRAN CRECEIVE). 
IF ADDERR OR TRANERR THEN UNDO. 

RECEIVE STX» TEXTs ETX. 

IF FORMATERR OR ENDOFBSUFFER THEN UNDO. 
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TERMINATE STATEMENT 


SYNTAX: 
<TERMINATE STATEMENT>?¢= TERMINATE <TERMINATE OPTION>. 
<TERMINATE OPTION>:2= DISCONNECT 

ECHO 

ERROR 

INPUT 


INPUT CRETURN) 
INPUT CRETURN» NO BUFFER) 
LOGICALICK © 

NOINPUT 

OUTPUT 

RELEASE STATION 

QUTPUT CRETURN) 


SEMANTICS: 


TERMINATE is used to exit a REQUEST. Depending on the _ option 
selected» the TERMINATE may cause buffer allocation/deallocation»s 
message queueing/dequeueingsr changes in station status» and saving 
of tne current REQUEST. If state is saved (See "RETURN® options) 
then the REQUEST can be restarted at the Statement following the 
terminate. If state is not saved (Catt other options) then the 
terminate ends the REQUEST. ee: 


ALL REQJESTs must end with a nonwstate"saving terminate. If none is 
supplied» no syntax error will result. Howevers should control falt 
past the last statement in the REQUEST» the compiler automatically 
generat2s a TERMINATE ERROR at the end. 
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TERMINATE OPTIONS: 


DISCINNECT 


Used in REQUESTs when the Ltast 1/0 had an error indicating loss of 
connection such as loss of data set ready. A break I/0 with’ the 
disconnect variant 15 tssued. If stations are stitt enabled on the 
liner a new test/wait for ring is sent. 


Used in receive REQUESTs to signal completion of an input line 
discipline. The result index is set to show successful input. The 
27-byte message header is appended to the input text» and the input 
message is queued for the MCS/user program. Any output message 
still attached 158 assumed to have been successfully transmitted» so 
the output buffer is decrallocated. The Line may now be used _ (for 
other I70. The REQUEST ends. ; 


INPUT CRETURN) 


Used to signal successful reception of a block (not the last) of 
inpute- As in "TERMINATE INPUT" the message 13 completed and queued. 
Another input buffer is allocated. No action is. taken on attached 
output nessages- Control is returned to the next REQUEST statement. 


INPUT SSE TUS NO BUFFER) 


Signals successful reception of an input messager but not comptetion 
of the line discipline. Input nessage 15s completed and queued. No 
new buffer is allocated. No action is taken on attached output 
messages. Flow of. control returns immediately to the next statement 
in sequence. This option 1s intended to be ‘used ‘to overtap 
processing of an input message by the MCS/user program with 
acknowla2dgement of reception by the REQUEST. 
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LOGIZCALACK 


The input REQUEST is interrupted but not ended and the input message 
queued. If LOGICALACK is true for this station and an MCS present» 
the. tnout message will be queued for the MCSs otherwise the input 
message is queued for the user program and the REQUEST continues. 


LOGICALACK is a method of verifying receipt of messages through = an 
MCS. The Network Controller will not restart if an error 1s 


detected as indicated by the message result: 


1. INVALID LSN IN RESPONSE 
@e LINE NOT WAITING FOR RESPONSE 
3e INCORRECT LSN IN RESPONSE 


OUT? UT 


Successful completion of an output Line discipline. <A completion 
message is queued for the MCS if required. Output buffer and any 
attached input buffer are devwatlocated. The REQUEST ends. 


OUTPUT CRETURN) 


Signals successful transmission of a block of output» but not 
completton of the line discipline. The old output buffer is 
demallocated» but no action is taken on any attached input buffer. 
The state of the REQUEST is saved» and the Line CONTROL is entered 
( LINECCONTROL KEY)=4 ).- The CONTROL must restart the REQUEST with 
a "CONTINUE". When the REQUEST is restarted» it begins to execute 
the statement following "TERMINATE QUTPUT CRETURN)"™. The REQUEST 
should test the value of “OUTPUTATTACHED*™ to determine if another 
output nessage has been attached before trying to transmit. 
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ECHO 


This option is supplied for writing REQUESTs for the initial 
shakedoan of an NDL datacomm system. Instead of putting an input 
message in the MCS queues "TERMINATE ECHO™ puts the message in the 
station's output queues so the station's output REQUEST can echo it 
back. [The input REQUEST is ended. 


Used to inform the NC of an unsuccessful attempt to transmit or 
receive. An error message 1s queued for the MCS or user program. I[f 
an MCS is present the station is marked down. Attached input 
buffers are released» while attached output messages are re-queued. 


NOINPUT 


Signals an unsuccessful attempt to receive input» but without errors 
(receiving an E0OT» for examples, ending a conversational line 

discipline). The tnput buffer is decrallocated» and any output 

message is resqueued for an output REQUEST. State is tost. 

"TERMINATE NOINPUT"™ may be used in a transmit REQUEST just to 

re-queu2 the output messager perhaps to broadcast a message to more 

than on2 station. 


RELEASE STATION 


Releases a station not physically present on one lines, making it 
available to other Lines in the Line groupe. TERMINATE RELEASE 


STATION clears the station table entry STATIONCLINE) to zero. 
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OPTION 


DISCONNECT 


ECHO 


ERROR 


INPUT 


INPUTCR= TURN) 


LOGICALACK 


OUTPUT 


QUTPUTCRETURN) 


RELEASE STATION 


INPUTCRZTURN> 


NO BUFFER) 


NOINPUT 


INPUT 
MESSAGE 


LOST 


QUEUED FOR | 


TRANSMIT 


LOST 


QUEUVED 


QUEUED 


QUEUED 


LOST 


NO ACTION 


LOST 


QUEUED 


LOST 
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TERMINATE 


OUTPUT 
MESSAGE 


Lost 
NO ACTION 
RE“QUEUED 
LOST 
NO ACTION 
LOST 
LOST 


LOST 


QUEUVED 


NO ACTION 


RE=QUEUED 
IF NECESS. 
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OPTIONS 


STATE OF 
REQUEST 
LOST 


LOST 
LOST 
LOST 


SAVED 
CIMMEDIATE 
RETURN) 


SAVED 
LOST 
SAVED. 


CCONTROL 
MUST 


. CONTINUE ) 


LOST 

SAVED 
CIMMEDIATE 
RETURN) 


LOST 


TYPE REQUEST 


eee eee 28 BH ODED TOTO TB BO OM BSH 2aensaeatctes DB assaeesaew aera aa 


ALL 

DEBUGGING 

RECEIVE» TRANSMIT» 
CONVERSATIONAL 


RECEIVE OR 
CONVERSATIONAL 


CONVERSATIONAL OR 
BLOCK RECEIVE 
RECEIVE 


TRANSMIT OR 
CONVERSATIONAL 


CONVERSATIONAL OR 
BLOCK TRANSMIT 


RECEIVE, TRANSMIT 


RECEIVE 


RECEIVE» TRANSMIT 
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TRANSMIT STATEMENT 


SYNTAX: 


<TRANSMLT STATEMENT>33= TRANSMIT <ITEM LIST>. 
<ITEM LIST>?22= <ITEM> 
1 <[TEM>» <ITEM LIST> 
<CITIM>22= ADDRESS <ADDRESS QUALIFIER> 
! TEXT : 
1 <STRING> 
1 <CONSTANT I[DENTIFIER> 
! TRAN <TRAN QUALIFIER> 
1 CHAR 
1 CHARACTER 
<ADDRESS QUALIFIER>::= CRECEIVE) 
: 1 CTRANSMIT) 
<TRAN QJALIFIER>22= (MESSAGE) 


' CRECEIVE) 
! CTRANSMIT) 
§ <EMPTY> © 
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SEMANTICS: 


The <TRANSMIT STATEMENT> is used for output to a station. <ITEMS> 
are concatenated untit the <ITEM LIST> 18 exhausted. <ITEMS> from 
subsequent <TRANSMIT STATEMENT>s are added to the concatenation 
until a “FINISH TRANSMIT" statement is executed» at which time the 
entire string is actually sent to the station. 


TRAN CRECELVED/ 


TRAN CTRANSMIT) @- Transmission number in the statton table. 

TRAN <EMPTY> - Equivalent to TRANCTRANSMIT) 

TRAN<EMPTY> = Transmission number from 27~-byte message 
header 


ADDRESSCRECEIVE)/ 
ADDRESSC TRANSMIT) = Address from station table. 


CHAR/CHARACTER = Character register. 


<CONSTANT IDENTIFER> - 
7<STRING> - Loads the specified characters. 
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JNDIJ STATEMENT 


SYNTAX: 
<UNDO STATEMENT> 3s 3= UNDG <DO OPTION>. 
<DO OPTION>: s= <EMPTY> 


{ <DO0 I[DENTIFIER> 


SEMANTICS: 


The UND} statement is used to exit a DO“GROUP. Upon execution of an 
UNDO» control transfers to the statement following the dovngroup'ts 


"END. 
DO OPTIIN: 


"UNDO." Transfers controt out of the innermost DO “GROUP in 
which the statement appears. 


"UNDO <IDENTIFIER>.* Transfers control out of the DO-GROUP 
with the same identifier. 


EXAMPLE: 
DO OUTER. 
DO. 
IF TOGCO] THEN UNDO. % EXITS UN-NAMED DO 
DO INNER. | 
| IF TOGC1} THEN UNDO. % EXITS "INNER" 
UNDO OUTER. % EXITS “NUTER* | 
END INNER 
END. 


EN) OUTER. 
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CONTROL SECTION 


SYNTAX: 


<CONTROW SECTION>D 3 ss <CONTROL LIST> 
<CONTRO. LIST>33:= <CONTROL> 

1 <CONTROL> <CONTROL LIST> 
<CONTROL>3 s= CONTROL <CONTROL IDENTIFIER>=: 


<CONTROL STATEMENT LIST> 


<CONTRO- STATEMENT 
LIST>::= <CONTROL STATEMENT> 
{ <CONTROL STATEMENT> 
<CONTROL STATEMENT LIST> 


<CONTRO. IDENTIFIER>::= <IDENTIFIER> 


<CONTRO_ STATEMENT>: 5: <ASSIGNMENT STATEMENT> 
<CASE STATEMENT> 

<CONTINUE STATEMENT> 
<DISPLAY STATEMENT> 

<DO STATEMENT> 

<IF STATEMENT> . 
<CONTROL INITATE STATEMENT> 
<NULL STATEMENT> 

<POLL STATEMENT> 

<UNDO STATEMENT> 


SEMANTICS: 


Each tine in an NOL system must have a CONTROL associated with it by 
means of the <LINE CONTROL STATEMENT> in the line section. The 

-user-written CONTROL is invoked by the NC when it is necessary to 

‘decide which of a set of contending I/70 functions gers the use of 

_the line. The duties of a CONTROL are 


le Creation of poll list» if any. 
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Ze Choosing a station ‘on the Line by testing system 


variables CLINE CCONTROL KEY)» STATION CQUEUED)>» 
FREQUENCY» "STATION™» etc.) or by polling. 


36 Initiation or restarting of the REQUEST for the 
chosen station. 


REQUESTs are treated as I/0 subroutines by CONTROLs. It is the 
CONTROL that decides when and for which station a given REQUEST is 
to be executed. The REQUEST is invoked by the <CONTROL INITIATE 


STATEMENT>. 


Unlike REGUESTs» CONTROLS may never save state and suspend 
themselves. CONTROLS are always entered at the first instruction 
and run until they execute an <INITIATE STATEMENT> or a <CONTINUE 
STATEMENT>» whereupon the CONTROL is terminated in favor of the NC 
or the appropriate REQUEST. ae 


The first thing a CONTROL should do is determine the state of the 
Line by checking the value of LINECCGNTIROL KEY). CSee SYSTEM STATUS 
VARIABL=S for the meaning of the different values). Certain values 
of this item Limit the range of action of the CONTROL or force the 
CONTROL to take one course of action. 


Six CONTROL statements CASSIGNMENTs CASE» DOO» IF» NULL» UNDO) are 
virtually identical to the corresponding REQUEST statements. The 
<CONTROL INITIATE STATEMENT> however serves an entirely different 
purpose from the <INITIATE STATENENT> tn the REQUEST section. 
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ASSIGNMENT STATEMENT 


<ASSIGNYENT STATEMENT>22= <CONTROL ASSIGNABLE VARIABLE> 
<ASSIGNER> <EXPRESSION>. 


<CONTRU. ASSIGNABLE 
VARIABLi>s := CSEE VARIABLES) 


SEMANTICS: 


Used t2 change the value of a system variable. The variable to be 
assigned» as well as any variables appearing in the expression» 
must be referenceable in CONTROLS.- Example: 


STATION:= STATION + 1. 


CASS STATEMENT 


SYNTAX: 

<CASE STATEMENT>:3= CASE <EXPRESSION>. 
<CONTROL STATEMENT LIST> 
END CASE. 


<CONTRO_ STATEMENT , 
LIST>2:= | <CONTROL STATEMENT> 


(| <CONTROL STATEMENT> 
<CONTROL STATEMENT LIST> 


SEMANTICS: 


Same as case in the REQUEST section. 
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CONTINUE STATEMENT 


<CONTINJE STATEMENT>2:= CONTINUE. 
SEMANTICS: 


Tne <CONTINUE STATEMENT> is used in conjunction with the "TERMINATE 
DUTPUT CRETURN)I"™ statement in the REQUEST sectton. It returns 
control to the instruction following the previous "TERMINATE 
OUTPUTCRETURN)®™ statement in the REQUEST section. 


DIS?LAY STATEMENT 


Same as display statement in REQUEST section. 
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30 STATEMENT 
SYNTAX: 
<D0 STATEMENT>:2= 


<DO0 HEAJ>33= 


<END PART>st= 


<DOO [LDENTIFIER PART>3:= 


<FOREVE? PART>::= 


SEMANTICS: 
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<D0 HEAD> 


<CONTROL STATEMENT LIST> 


<END PART> 


DO<DG YTOENTIFIER PART> 
<FOREVER PART>. 


END <DQO [DENTIFTIER PART>.- 


EMPTY> 
<IDENTIFIER> 


<EMPTY> 
FOREVER 


Same as REQUEST section <O0Q STATEMENT>. 
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SYNTAX: 


<IF STATEMENT>:3= 


cELSE PART>3s s= 


SEMANTICS: 
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IF<EXPRESSION> THEN <CONTROL 
<ELSE PART> 


ELSE <CONTROL STATEMENT> 
<EMPTY> 


Same as REQUEST section <IF STATEMENT>. 


STATEMENT> 


NOTE s Variables in the <EXPRESSION> must be CONTROL~referenceable. 
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SYNTAX: 


<CONTRO.L INITIATE 
STATEMENT>33= INITIATE <INITIATE OPTION> 


<INITIATE OPTION>:2= © <I~O OPTION> 
<AUTOPOLL OPTION> 
<IDLE OPTION> 
<CANCEL OPTION> 
<DISCONNECT OPTION> 


<I-0 OPTIQN>::= INPUT 

; OUTPUT 
INPUTOUTPUT 
OUTPUTINPUT 
INPUTCNO BUFFER) 
OUTPUTCNO BUFFER) 


<AUTOPOLL OP TION>::= AUTOPOLL<AUTOPOLL SLAVE ADDRESS> 
<AUTOPOLL SLAVE ADDRESS>22= (<INTEGER>) 
{ <EMPTY> 
<IDLE O? TION>s2= : IOLE 
<CANCEL OPTION>::= CANCEL 


<DISCONVECT OPTION>: := DISCONNECT. 
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SEMANTICS: 


INITIAT= is a statement that (1) ends the CONTROL» and (2) depending 


on the options either starts an I/0 REQUEST+ cancels an I/0 in 
progress» starts hardware autopoll» or idles the Line. The initiate 
option executed must be appropriate to the current Line and current 
station statuse For instance “INITIATE OUTPUT™ if there is -no 
message queued for the current station wilt cause ae fatal 
run-error. It 1s the NOL programmer's responsibilty to etther test 
allt relevant conditions before executing an Initiates» or to 
structure his NOL program so that’ the INITIATE cannot be 
inappropriate. See following for requirements of each option. 
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1-0 OPTLON: 


ALL I-0 option variants begin a REQUEST. Which REQUEST ts chosen 
depends on the variant and the stationts <TERMINAL REQUEST 
STATEMENT> as defined in the terminal section. 


INITLAT= INPUT starts the input REQUEST» attaches an input buffer 
and sets INPUTATTACHED to true. The station must be valid» ready» 
enabledr and STATION C(MYUSE) must altow tnput (See <MYUSE 
STATEMENT> in the station section). Example: 


IF STATIONCVALID) AND STATIONCREADY) AND 
STATION CENABLED) AND CSTATIONCMYUSE) NE 2) 
THEN INITIATE INPUT. 


INITIATE INPUTCNO BUFFER) also starts the input. REQUEST» but = no 
input buffer is attached. [To get an input buffer later» the REQUEST 
must execute a TERMINATE INPUTCRETURN).« Same requirements as 
"INITIATE INPUT". 


INITIAT= OUTPUT starts the output REQUEST» attaches an output 
mess ager and sets GUTPUTATTACHED to true. The current station must 
be valid» ready» queueds and STATIONCMYUSE) must permit output. 


INITIAT= OUTPUTCNO BUFFER) is just Like INITIATE OUTPUT» but no 
message 18 attached» even though one must be queued for output in 
order to execute this initiate. To get the message while running» 
the REQJEST must execute a TERMINATE OUTPUTCRETURN). 


INITIAT= INPUTOUTPUT starts the tinput REQUEST». while INITIATE 
OUTPUTINPUT starts the output REQUEST. Otherwise they have the same 
effect =- both get an input buffer and an output message» and both 
set IN?UTATTACHED and OQUTPUTATTACHED true. The station must be 
enabled» valid» ready and queued» and STATIONCMYUSE) must equal 3 
CI/0). These initiates are used to start conversational Line 
disciplines. 
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AUTOPOL_ OPTION: 


This initiate takes the poll string built by means of the <POLL 
STATEMENT> and fires an 1/9 starting recirculating polling 
C"AUTOPILL™). Polling continues automatically until a message is 
received or an error occurs. Then “STATION” is set to the proper 
value and the input REQUEST is entered» as if an “INITIATE INPUT" 
had be2n excuted. The REQUEST should check for I/0 exception. 
Reminitiating autopoll causes polling to pick up where it Left off. 
The poltt string need only ode re~built to add or delete a station. 


<AUTOPG_L SLAVE ADDRESS> is required only when the station may reply 
with address different from the polled address» as in controller - 

slave station configurations. The tnteger specifies the position of 

the first character of the slave station address in the message 

received. Noter-the characters in the message are numbered from 1» 

s0 if the address began tn the third character of the message» the 

integer should equal “3”. 


IDLE OPTION:: 


The lina is put in a state of semicpermanent rest. It is marked not 
busy buat left ready. While idles the Line CONTROL will not be 
entereds so the Line wilt not respond to stations attempting input 
and any messages that were queued for output on the line at the 
time it was idled wilt not be transmitted. This command might be 
used to ease the load on the system by deactivating a line on which 
no traffic is expected. Initiate idle terminates the CONTROL Cit is 
reenter2d from the top). The line can be reactivated by 3 events: 


1. An MCS "CHANGE" command to the NC. 


2 A file open by a user program involving a 
station on this Lines if no MCS is present 


3. An output message is queued for a station on 
this lines, and this station has no_ other 
messages. queued. 
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CANCEL JPTION: 


Halts the read I/0 that is presently in progress on this line. Since 
a line can only perform one task at a times the line CONTROL is not 

normally entered while an 1/0 is tn progress. An exception. occurs 

when 


=f The line is performing a read that can go. on 
indefinitely Cautopolls» read with no timeout)» 
and 
Ze The Line has no output messages queued» and 
36 A message 18 now queued (for output» in 


contention with the ongoing read. 


The CONTROL is entered with LINE CCONTROL KEY) equal to 2% giving it 
an opportunity to stop the read with an “INITIATE CANCEL”. After 
cancelling the read» the NC will rementer the CONTROL with LINE 
(CONTRO_ KEY) equal to 0. 


DISCINNZCT OPTION: 


Shuts down a liner releases associated stations» and hangs up. Used 
when all stations no ltonger require service (not enableds timing 
out» not performing outputs etc.). 


NUL. STATEMENT 


Same as null statenent. in the REQUEST section. 
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POLLY STATEMENT 


SYNTAX: 
<POLL STATEMENT>: 3= POLL<POLL ELEMENT LIST>. 
<POLL ELEMENT LIST>::= <POLL ELEMENT> . 
{ <POLL ELEMENT>»<POLL ELEMENT LIST> 

<POLL E-EMENT>3:3= <CONSTANT [DENTIFIER> 

1 <STRING> 

i <ADDRESS> 
<ADDRESS>:s= | ADDRESS 
: 1 ADDRESSCTRANSMIT) 
SEMANTICS: 


Used to create a pott string prior to initiating autopott (See 
AUTOPOL. option of <CONTROL INITIATE STATEMENT>). The Line CONTROL 
should cycte through the stations on the liner executing POLL once 
for each station to go in the poll string- A <POLL ELEMENT CLIST> 
must Contain exactly one occurrence of <ADDRESS>. ADDRESS and 
ADDRESSCTRANSMIT) are equivalent in the poll statement. The poll 
fist should be rebuilt when LINE CCONTROL KEY)= 1 (See VARIABLES> 
LINECCONTROL KEY)). ; 


RESTRICTIONS: 


les Every  <POLL ELEMENT LIST> entered in the same 
polt string must have the same total length. 


Ze Max imum Length of a <POLL ELEMENT LIST> is 15 
characters. 


3. The total tength of the poll string should not 
exceed the length specified itn the <AUTOPOLL 
SIZE  STATEMENT> in the Line section. If it is 
exceeded» ENDOFBUFFER is set true. 
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4e The <POLL STATEMENT> should be executed only for 
; stations that are readye valide and enableds and. 
myuse must permit tnpute 


Se Group poll: If the system includes 
controller-slave stations (TU910 = TU510» for 
example)» STATION CTYPE) should be checked to 
avoid polling slave stations. 


EXAMPLE : 


STATION 2= le 
OO FOREVERSs 
IF STATION CVALID) AND STATION CREADY) AND 
STATION CENABLED) AND CSTATIONCMYUSE) NE 2) AND 
CSTATIONCTYPE INE 1) 
THEN POLL EOQT» ADDRESS»POL»> 4™2E™. 
IF ENDOFBUFFER THEN UNDO. 
IF STATION EQ MAXSTATIONS THEN UNODO>s 
STATION:= STATION + 1. 
END. 
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JNDI STATEMENT 


SYNTAX: 
<UNDO STATEMENT> 3 s= UNDO <00 OPTION>. 
<DO OPTION>::= <00 IDENTIFIER> 
1 <EMPTY 
SEMANTI2S: 


Same as undo in REQUEST section. 
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TERMINAL SECTION 


SYNTAX: 


<TERMINAL SECTION>s3= 


<TERMINAL LIST>:3= 


<TERMINAL DEFINITION>$s= 


<TERMINAL DEFAULT> 
DEFINITION>: s= 


<TERMINAL ATTRIBUTE 
LIST::= 


<TERMINAL ATTRIBUTE 
STATEMENT : 


<TERMINAL IDENTIFTIER>:2= 


<TERMINAL DEFAULT 
IDENTIFIER>: 3= 


Cot 
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<TERMINAL LIST> 


<TERMINAL DEF INITION> 

<TERMINAL DEF INITIOGN> <TERMINAL LIST> 
<TERMINAL DEFAULT DEFINITION> <TERMINAL 
LIST> 


TERMINAL <TERMINAL IDENTIFIER>: 
<TERMINAL ATTRIBUTE LIST> 


TERMINAL DEFAULT <TERMINAL IDENTIFIER>: 
<TERMINAL ATTRIBUTE LIST> 


<TERMINAL ATTRIBUTE STATEMENT>. 
<TERMINAL ATTRIBUTE STATEMENT>. 
<TERMINAL ATTRIBUTE LIST> 


<HEADER SIZE STATEMENT> 
<MAXINPUT STATEMENT> 
<TERMINAL ADDRESS STATEMENT> 
<TERMINAL DEFAULT STATEMENT> 
<TERMINAL DIAGNOSTIC REQUEST 
<TERMINAL REQUEST STATEMENT> 
<TERMINAL TYPE STATEMENT> 
<TRANSMISSION NUMBER STATEMENT> 


STATEMENT> 


<IDENTIFIER> 


<IDENTIFIER> 
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RESTRICTIONS: 


1. At least one <TERMINAL DEFINITION> must appear in the 
<TERMINAL SECTION>. 


2. A  <TERMEINAL OEFAULT DEFINITION> must predede any 
reference to it in a <TERMINAL DEFAULT STATEMENT>. 


3. The <TERMINAL DEFAULT STATEMENT> may appear in a 
<TERMINAL DEFINITION> but not in a <TERMINAL OEFAULT 


DEFINITION> Cdefaults may not ose nested). 


SEMANTIZS: 


The terninal section contains descriptions of every different type 
of remote device connected to the user's datacomm system- For 
example, if the system consists of TC7500's and TD=-700's» two 
terminal definitions are required in the terminal sections one for 
the T27500 and one for the TO7700~. This section is linked to the 
rest of the NOL program as fotlows: Terminals are associated with 
REQUZISTs by the <TERMINAL REQUEST STATEMENT> and the <TERMINAL 
DIAGNOSTIC REQUEST STATEMENT>. A’ station is associated with a 
terminal definition by the <TERMINAL STATEMENT> in the STATION 
section. 


{=3 


BURRIUGIS CORPORATION COMPANY CONFIDENTIAL 
COMPUTER SYSTEMS GROUP B1700 NETWORK DEFINITION LANGUAGE 
SANTA BARBARA PLANT PeSe 2212 5223 


ATTRIBUTE STATEMENTS: 


Only thea <TERMINAL REQUEST STATEMENT> and the <MAXINPUT STATEMENT> 
are apsolutely required in every <TERMINAL DEFINITION>. Compiler 
warnings will be printed if the terminal address» reader size» 
type» and transmission number statements are omitted. 


TERMINAL DEFAULT DEFINITIONS: 


For terninals which have several common attributes, the common 
attributes can be grouped in a <TERMINAL DEFAULT DEFINITION>. The 
remaining attributes can be listed explicitly under each individual 
<TERMINAL ODEFINITION>» and a <TERMINAL DEFAULT STATEMENT> wilt 
comptlet2 the definition. 
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TERMINAL oe AUET Tee 


SYNTAX: 


<TERMINAL DEFAULT 
STATEMENT>2:= DEFAULT = <TERMINAL DEFAULT IDENTIFIER> 


SEMANTICS: 


This statement specifies the identifier of a preceding <TERMINAL 
DEFAULT DEFINITION> . The attributes in the default are added to 
the exolicit attributes contained in the <TERMINAL DEFINITION> in 
which this statement appears. ; 


RESTRICTIONS: 


Ls If' a default attribute conflicts with an explicit 
attribute in the same terminal definition» the 
explicit attribute is given precedence. 


Ze This statement cannot appear in a <TERMINAL DEFAULT 
DEF INITLON>. 
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EXAMPLE: 


Assume terminals Al» A2» and A3 have the same attributes. 
<TERMINAL DEFAULT STATEMENT> could be used as ittustrated below 
Simplify the coding of the descriptions of these 3 terminals. 


TERMINAL DEFAULT A123DFLT: 


REQUEST = TWXREADZRECEIVE»TWXWRITES TRANSMIT. 
MAX INPUT = 72. 
ADDRESS = NULL. 
TERMINAL Al: 

DEFAULT = A123DFLT. 
MAXINPUT = 95-6 
TERMINAL A2? 

DEFAULT = A123D0FLT. 
ADDRESS = 2 

TERMINAL A35 . 
DEF AULT = A1L23DFLT. 


A 
to 
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SYNTAX: 


<TERMINAL ADDRESS 
STATEMENT>s3= © ADDRESS = <RECEIVE ADDRESS> 


<TRANSMIT ADDRESS PART> 
1 ADDRESS = NULL 


<RECEIVE ADDRESS>: <= <AUVDRESS SIZE> 


<TRANSMIT ADDRESS PART>33= <TRANSMIT ADDRESS> 1<EMPTY> 


<TRANSMIT ADDRESS>: = <ADDRESS SIZE> 
<ADDRESS SIZE>2s= Lobe 4.3 
SEMANTICS: 


The <TERMINAL ADDRESS STATEMENT> specifies the number of characters 
which are used to address a station associated with a terminate An 
empty <TRANSMIT ADDRESS PART> implies the transmit address its of 
the same tength as the receive address. A non-empty <TRANSMIT PART> 
indicat3?s that the transmit address may be nontidentical to the 
receive address. [Jf this statement is omitted» both address lengths 
are assumed to be zero. 
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MAXINPUT STATEMENT 


SYNTAX: 


<MAXINPJT STATEMENT>23= MAXINPUT = <INTEGER> 


SEMANTISS: 


The <MAXINPUT STATEMENT> aopties only to inputs from the terminal 
and defines the maximum size (in characters) of an input message. 
The <INTEGER> must be Less than 4096. This statement ts required in 
all terminal definitions. 27 bytes for the header and 5 bytes’ for 
the trailer are added to the maxinput size to determine the input 
buffer length. 
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4EAQER SIZE STATEMENT 


SYNTAX: 


“HEADER SIZE STATEMENT>: := HEADER = <I NTEGER> 
SEMANTIZS: 


The <HEADER SIZE STATEMENT> defines the expected size of the 
text haader Ci.e. SOH“"“-STX) on input from this terminal. The 
<INTEGER> must be less than or equal to 27. Size is assumed to 
be zero if this statement is omitted. 
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TERYINAL REQUEST STATEMENT 


SYNTAX: 


<TERMINAL REQUEST | 
STATEMENT> 2 3= REQUEST = <REQUEST SPECIFIER LIST> 


<REQUEST SPECIFIER LIST>::s= <INPUT SPECIFIER> 
{1 <OUTPUT SPECIFIER> 
( <INPUT SPECIFIER>» <QUTPUT SPECIFIER> 
§ <QUTPUT SPECIFIER>» <INPUT SPECIFIER> 


<INPUT SPECIFIER>::= <REQUEST IDENTIFIER>: RECEIVE 
<QUTPUT SPECIFIER>3s2= © <REQUEST IOENTIFIER>: TRANSMIT 
SEMANTICS: 


This required statement Links the terminal with one of two Line 
disciplines  CREQUESTS). When input is to be received from a 
station> the station's terminalttable entry is checked and the 
REQUEST identified in the <INPUT SPECIFIER> is called. 
Similarly on output» the REQUEST from the <OUTPUT SPECIFIER> is 
called. 


The <REQUEST LIST> may specify etther the input REQUEST or’ the 
output REQUEST» or both. The same REQUEST can be used for both 
input and output. For example: 


REQUEST = L[OTTY33:RECEIVE» IOTTY33: TRANSMIT. 
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TRANSMISSION NUMBER STATEMENT 


SYNTAX: 


<TRANSMISSION NUMBER 
STATEMENT>2:= TRANSMISSION = <TRANSMISSON NUMBER> 


<TRANSMISSTON NUMBER>=: 3= O'tbtt 2st 3 ' NULL 


SEMANTICS: 


The <TRANSMISSION NUMBER STATEMENT> specifies the length of the 
transmission number. The number zero and NULL are equivalent = = and 
specify that no transmission number wilt be usede A  non=NULL 
transmission number must be specified if the item "TRAN" is 
mentioned in a REQUEST of the terminal. . 


TERMINAL DIAGNOSTIC REQUEST STATEMENT 


SYNTAX 


<TERMINAL DIAGNOSTIC 
REQUEST STATEMENT>:2= DIAGNOSTIC = 
<REQUEST SPECIFIER LIST> 


SEMANTICS: 


This optional statement specifies an alternate REQUEST that can be 
used far diagnostic reasons. A “DOCWRITE™* from the MCS is required 
to initiate the dtagnostic REQUESTs. 
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TERYINAL TYPE STATEMENT 


SYNTAX: 
<TERMINAL TYPE STATEMENT>:s3:= TYPE = <TYPE NUMBER> 
<TYPE NJMBER>S3= <INTEGER> 


SEMANTICS: 


On input messages» an eight-bit field in the message header is 
automatically set to the terminal type specified for this current 
station. The value of <TYPE NUMBER> must be less than 64. The 
following hardware terminal type2s are recommended. | 


1 = TC500 
2 = CONRAC (WIDE) 
3 = RT2000 
4 = TOUCH TONE 
5 = TU300 
6 = TC3500 
7 = DC140 
8 = TC4000 
9 = TC5100 
10 = TT102 
ll = TC700 
12 = CONRAC CNARROW) 
13.00 = 0C110 
14 = TELETYPE 
15 = TU400 
210 = TC1700 
2200 = BIDS 
25°0=«= TU500 
32, = 10700 
3500 = TU700 
42 0 = T0800 
45 = TU800 
62 = 31700 
63) = B6700 
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The users howevers has the option of assigning any hardware type and 
this will be passed in the message header. If this statement does 
not apoear tn a terminal definitions a compiler warning will be 
printed and type will be assumed zero. 
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STATION SECTION 
SYNTAX: 


<STATION SECTION>: c= 


<STATION LIST s= 


<STATION DEF INITION><3s= 


<STATION DEFAULT 
DEFINITION>: = 


<STATION ATTRIBUTE LIST>: 


<STATION ATTRIBUTE 
STATEMENT><s2= 


<STATION IDENTIFIER> 22= 


<STATION DEFAULT 
IDENTIFIER>: s= 


B=-1 
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<STATION LIST> 


<STATION OEFINITION>. 
<STATION DEFINITION> <STATION LIST> 
<STATION DEFAULT DEFINITION> <STATION LIST> 


STATION <STATION IDENTIFIER>: 
<STATION ATTRIBUTE LIST> 


STATION DEFAULT <STATION 
DEFAULT IDENTIFIER>: 
<STATION ATTRIBUTE LIST> 


<STATION ATTRIBUTE STATEMENT>. 
<STATION ATTRIBUTE STATEMENT>. 
<STATION ATTRIBUTE LIST> 


<CONTROLLER STATEMENT> 
<FREQUENCY STATEMENT> 
<LOGICALACK STATEMENT> 
<MCSQUEUE STATEMENT> 

<MYUSE STATEMENT> 

<RETRY STATEMENT> — . 
<STATION ADDRESS STATEMENT> 
<STATION DEFAULT STATEMENT> 
<STATION TERMINAL STATEMENT> 


<IDENTIFIER> 


<IDENTIFIER> 
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RESTRICTIONS: 


le At least one <STATION DEFINITION> must appear in 
the <STATION SECTION>. 


20 A <STATION DEFAULT DEFINITION> must precede any 
reference to it in a <STATION DEFAULT 


STATEMENT>. 


Be The <STATION DEFAULT STATEMENT> may appear in a 
<STATION DEFINITION> but not in a <STATION 
DEFAULT DEFINITION> (no nested defaults). . 


SEMANTICS: 


Each. individual remote device in an NDL system must be defined in 
the station section. AS in the terminal sections default 
definitions are provided as a coding aid. 


BURRIJUGIS CORPORATION 
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CONTROLLER STATEMENT 
SYNTAX: 


<CONTROLLER STATEMENT>23:= 


<STATION CONTROLLER TYPE>:: 


SEMANTIZS: 


8-3 


COMPANY CONFIDENTIAL 
B1700 NETWORK DEFINITION LANGUAGE 


PeSe 2212 5223 


CONTROLLER = <STATION CONTROLLER 
TYPE> 


TRUE 
FALSE 
<STATION ITDENTIFIER> 


The statement is only required for stations that are part of a 
CONTROLLER SLAVE station configurations Like TU910 - TU510"s. The 
<CONTRO_LER STATEMENT> makes it possible to use group polling in 
the Line CONTROL (See <POLL STATEMENT>). A station's CONTROLLER 


status can be accessed 
STATIONCTYPE). 


CONTRILLER TYPE 


<STATION I[DENTIFTIER> 


at runtime by using the variable 


MEANING 


This station is a controllers» like TU910. 


This station is a regular remote device. 
This ts the default value. 


This station is a slaves like a TUS10> 

and <STATION IDENTIFIER> tis its controtler. 
<STATION IDENTIFIER> must refer to 

a preceding station definition. 
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FREQUENCY STATEMENT 


SYNTAX: 
<FREQUENCY STATEMENT>: := FREQUENCY = <I0 FREQUENCY> 
<I0 FREQUENC Y>3:s= <INTEGER>»<INTEGER> 


{ <INTEGER> 


SEMANTICS: 


The <FRZQUENCY STATEMENT> specifies a priority for tnput and output 
for us2 by the station in the Line CONTROL section. The maximum 
number which may be specified is 255. The first integer defines the 
input oriortty and the second integer defines the output priority. 
The default value ts zero. 


EXAMPLE: 
FREQUENCY = 37. 
= 3. 


FREQUENCY 


LOGICALACK STATEMENT 


<LOGICA.ACK STATEMENT>:s:= LOGICALACK = <LOGICAL VALUE>. 


SEMANTI2S: 


TRUE is required if the REQUEST is actually to be interrupted. 


If this statement is omitted» LOGICALACK defaults to “FALSE”. 


8-5 


BURRIUGIS CORPORATION COMPANY CONFIDENTIAL 
COMPUTER SYSTEMS GROUP B1i700 NETWORK DEFINITION LANGUAGE 


SANTA BARBARA PLANT PeSe 2212 5223 
MCSQUEUVE STATEMENT 


SYNTAX: 


<MCSQUEJE STATEMENT>::= MCSQUEUE = <QUEUE NAME> 
<QUEUE VAME>s2= <QJEUE FAMILY> 
1 <QUEUE FAMILY> <SLASH> <QUEUE OFF SPRING> 
<QUEUE -AMILY>33= <EBCDIC STRING> 
<QUEUE JFFSPRING>::= <EBCDIC STRING> 
SEMANTI2S: 


This statement informs the NC of 1) the presence of an MCS in the 
user's .datacomm systems» and 2) the name of the MCS's Input queue. 
It is required if and only if an MCS is to be present. The actual 
name used by the MCS queue is a 20-character field. The <QUEUE 
FAMILY> is teftctjustified in the first 10 characters» while <QUEUE 
OFFSPRING> is lLeft-justified in the second 10 characters. Examples: 


MCSQUEUE 


"USERSMCS7/ “INPUTQUEUE™. 


MCSQUEVE "MCSIN"™. 


If the aser intends to use the ILLUSTRATIVE MCS supplied by 
Burroughs» set MCSQUEUE to "MCS.QUEUE*™. 


For the V.0 release» this statement need only appear once in the 
Station section» in any station. definition. 
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MYUSE STATEMENT 


SYNTAX: 
<MYUSE STATEMENT>3::s= MYUSE = <I0 LIST> 
<IO LIST>::s=- INPUT 


1. OUTPUT 
{1 INPUT» OUTPUT 
§ OUTPUT» INPUT 


SEMANTICS: 


This required statement specifies the allowed use of ae station-- 
inputs outputs or both. [t should be consistent with the <REQUEST 
STATEMENT> of this station's terminal definition (See terminal 
REQUEST statement) and with tha I/0 initiation in the tine CONTROL 
(See <ZTONTROL INITIATE STATEMENT>)« MYUSE can be changed at 
runstime by an MCS communicate. The MYUSE status can be checked at 
runstime by accessing the variable STATIONCMYUSE). 


10 IST STATION CMYUSE) VALUE 
INP JT 1 
OUT? UT 2 
INPJT» OUTPUT 5 
OUTPUT» INPUT 3 
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RETRY STATEMENT 


SYNTAX: 


<RETRY STATEMENT>32= © RETRY = <INTEGER> 


SEMANTI2S: 


The <RETRY STATEMENT> gives the initial retry count for the station. 
At run times the value may be changed by the MCS or by INITIALIZE 
RETRY tn a REQUEST. The <INTEGER> must be tess than 256. 
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SYNTAX: 


<STATION ADDRESS 
STATEMENT>33= ADDRESS = <STATION ADDRESS LIST> 


<STATLION ADDRESS LIST>2::= <RECEIVE*TRANSMIT ADDRESS> 
1 <RECEIVE ADDRESS>» <TRANSMIT ADDRESS> 


<RECEIVE*TRANSMIT 


ADDRESS> 322 <EBCDIC STRING> 
<RECELV= ADDRESS>: 3= <EBCDIC STRING> 
<TRANSMIT ADDRESS>2:= <EBCDIC STRING> 
SEMANTICS: 


The <STATION ADDRESS STATEMENT> is used to specify the address of a 
station for operations such as polling and selecting. If no 
<STATION ADDRESS STATEMENT> ts defined for a stations the mode of 
the associated terminal must be contention. The tength of the 
address specified must be equal to the Length as defined in the 
<TERMINAL ADDRESS STATEMENT> of the associated terminal. 


An address pair should be defined only if the station's receive and 
transmit addresses are different. The first member of an address 
pair is the receive address» the second the transmit address. 
Examples: 


" 


ADDRESS wOLt. 


ADDRESS "O10", "011". 


iT} 
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STATION DEFAULT STATEMENT 


SYNTAXs 


<STATION DEFAULT 
STATEMENT>23= DEFAULT = <STATION DEFAULT IDENTIFIER> 


SEMANTICS: 


The <STATION DEFAULT STATEMENT> 18 used tn the same manner that a 
<TERMINAL DEFAULT STATEMENT> is used. The <TERMINAL DEFAULT 
STATEMENT> ts discussed under the description of terminat default 
semantics. . : 


STATION TERMINAL STATEMENT 


<STATION TERMINAL 
STATEMENT>23= : TERMINAL = <TERMINAL IDENTIFIER> 


SEMANTICS: 


This statement is required in every <STATION DEFINITION>. The 
<STATION TERMINAL STATEMENT> specifies the name -of the terminal 
description which defines the physical characteristics of the 
station being described. More than one. station description may 
reference the same terminal description. 
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LINE SEZTION 


SYNTAX: 


<LINE SZCTION>::= <LINE LIST> 
<LINE LIST>::= <LINE DEFINITION> 
1 <LINE DEFINITION> <LINE LIST> 3 
1 <LINE DEFAULT DEFINITION> <LINE LIST> 
<LINE JZFINITION>: $= LINE <LINE IDENTIFIER>: 
<LINE ATTRIBUTE LIST> 
<LINE DZFAULT DEFINITION>:2= LINE DEFAULT <LINE DEFAULT 
| IDENTIFIER>: 
<LINE ATTRIBUTE LIST> 


<LINE ATTRIBUTE LIST>::= LINE ATTRIBUTE STATEMENT>. 
. : 1 <LINE ATTRIBUTE STATEMENT>. <LINE 
ATTRIBUTE LIST> 


<LINe ATTRIBUTE 

STATEMENT>::= <AUTOPOLL SIZE STATEMENT> 
<LINE ADDRESS STATEMENT> 
<LINE CONTROL STATEMENT> 
<LINE DEFAULT STATEMENT> 
<LINE STATION STATEMENT> 
<LINE TYPE STATEMENT> © 
<MAXINWORK STATEMENT> 
<MAXOUTWORK STATEMENT> 


<LINE ITJENTIFIER>: 2= <IDENTIFIER> 


<LINE DEFAULT 
IDENTIFIER>: c= <IDENTIFIER> 


BURRIUGIS 
COMPUTER 
SANTA BAR 


RESTRICTI 


1. 
Ze 


36 


SEMANTICS: 


Each tine 


in the terminal section> 


coding a1 
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ONS: 


At least one <LINE PEST EET AON? must appear in 
the Line section. 


A <LINE OEFAULT ODEFINITION> must precede a 
reference to it tn a <LINE DEFAULT STATEMENT>. 


The <LINE DEFAULT STATEMENT> may appear in a 
<LINE DEFINITION> but not tn a <LINE ODEFAULT 
DEFINITION> (Cdefaults may not be nested). 


The <LINE STATION STATEMENT> may not appear in 
<LINE DEFAULT DEETNTT TON? Ss A station may only 
be on one tine. 


The <LINE ADDRESS STATEMENT> may not appear in 
<LINE DEFAULT DEF INITION>s.~ 


in an NOL system nust be described in the line section. 
default definitions are provided 


d. 


as 


As 
a 


ae 
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AUTOPOLL SIZE STATEMENT 


SYNTAX: 


<AUTOPO_L SIZE STATEMENT>:3= AUTOPOLL = <INTEGER> 


SEMANTICS: 


The <AUTOPOLL SIZE STATEMENT> defines the maximum size in characters 
of an autopoll buffer. This buffer will contain the poll tist for 

the tine as supplied by the Line CONTROL section through the use of 

the "PO_L™ syntax. The maximum value of <INTEGER> is 1023. 
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LINS AODRESS STATEMENT 
SYNTAX: 


<LINE AJDRESS STATEMENT>:s= <LINE AODRESS LIST> 


<LINE AJDRESS LIST>2:2= <LINE ADDRESS> 
1 <LINE ADDRESS> » <LINE ADDRESS LIST> 
<LINE AJDRESS>:2:= <PORT NUMBER> =: <CHANNEL ADDRESS> : 
<ADAPTER ADDRESS 
<PORT NJMBER>::=_ OWL IZ1384151617 
<CHANNEL ADDRESS>2::= OULIZIZIGISIGI7ZIBIDILON 


118129135914115 


<ADAPTE? ADDRESS>22= O81Li2tst4i516171819110 
: 118121313014915 


SEMANTICS: 


Required for each Liner» the tine address statement is used _ to 
specify the port numbers» the channel number and the adapter number 
Within the channel to which the line ts attached. Two lines may not 
have the same addresse Example: ; 


ADDRESS = 2:0:15. 
This statement would appear in the tine description of the Line 
which is connected to channet number zero at adapter number 15. of 


port nunber two. 


With. sW#itched lines» a particular Line may have several atternate 
address2s- The addresses witl be checked ttn the order listed. 
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LINE CONTROL STATEMENT 


SYNTAX: 


<LINE CONTROL STATEMENT>::= CONTROL = <CONTROL IDENTIFIER> 


SEMANTICS: 


This required statement associates a CONTROL procedure with this 
line. The <CONTROL IDENTIFIER> must have been defined in_ the 


CONTROL section. 


LINE DEFAULT STATEMENT 


<LINE DZIFAULT STATEMENT>:3= DEFAULT=<LINE DEFAULT IDENTIFIER> 


SEMANTICS: 


The <LINE DEFAULT STATEMENT> ts used in the same’ manner that a 
<TERMINAL DEFAULT STATEMENT> is used.e. The <TERMINAL DEFAULT 
STATEMENT> is descussed under the description of terminat default 
semantics. ; 
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LINE STATION STATEMENT 


<LINE STATION STATEMENT>::= STATION = <LIST OF STATIONS> 


<LIST OF STATIONS>22= <STATION IDENTIFIER> 
1 <LIST OF STATIONS>» <STATION IDENTIFIER> 


SEMANTICS: 


Required for each tines the <LINE STATION STATEMENT> identifies the 
stations ona tine. Lines designated as passive must not have a 
<LINE STATION STATEMENT>+- A station may be associated with onty one 
Line and may not be defined twice for the same tine. <STATION 
IDENTIFIER> must have been defined in the STATION section. 
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LIN: TYPE STATEMENT 


See 

<LINE TYPE STATEMENT>3::= TYPE 
aes 

A line nay be declared in NDL but 


passive type statement. 


This statement is optional and 
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= PASSIVE 
kept inactive through use of the 


if onitted>, the tine witl be 


considered active and its type determined through the hardware. 


EXAYWPLE: 
LINE L1: 
ADDRESS = 4:32:11. 
CONTROL = AUTOPOLCTL. 
STATION = Bl. 
TYPE = PASSIVE. 
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MAXINWORK STATEMENT 


SYNTAX: 


<MAXINWIRK STATEMENT>3$ c= | MAXINWORK = <INTEGER> 


SEMANTICS: 


Defines the maxium size in bytes of an input workarea for the line. 
tt should be set just large enough to contain the longest CONTROL 
message expected from any station on the tine. The workarea is 
located within baserto-limitss» in the tine table.- Workarea is 
intended to be used onty to accept CONTROL message (See “INITIATE 
RECEIVE (C(CONTROL)*” tn the REQUEST section)» since text would 
overflow it. | 


Note: <INTEGER> may not exceed 27. The default value is zero. 


MAXIJUTWORK STATEMENT 


SYNTAX: 


<MAXIJUTNORK STATEMENT>ss= MAXOUTWORK = <INTEGER> 


SEMANTICS: 


<MAXOUTWORK STATEMENT> defines the maximum size of an output 
workarea for the Lines. This output workarea may be used _ for 
transmitting CONTROL messages to a station such as "ACK™ using the 
syntax "TRANSMIT ACK" "FINISH TRANSMIT™ in the REQUEST section. The 
<INTEGER> must be at least as large as the maximum size of any 
header sent with a message on the line (ie. SOH « « «| STX) and 
must. not be greater than 27. The default value is 0. 
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FILE SESTION 


SYNTAX 


<FILE S=CTION>::= 


<FILE LIST>32= 


<FILE JEFINITION>? 3= 


<FILE DZFAULT 
DEFINITION>s = 


<FILE ATTRIBUTE LIST>?23= 


<FILE ATTRIBUTE 
STATEMENT>3ss= 


<FILE LIJENTIFIER>:? s= 


<FILE DEFAULT 
IDENTIFIER>2 s= 
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<FILE LIST> 

<FILE DEFINITION> 

<FILE LIST> <FILE DEFINITION> 
<FILE DEFAULT DEFINITION> <FILE LIST 
<FILE IDENTIFIER>2<FILE ATTRIBUTE LIST> 
FILE DEFAULT <FILE DEFAULT IDENTIFIER>: 
<FILE ATTRIBUTE LIST> 

<FILE ATTRIBUTE STATEMENT>. 


<FILE ATTRIBUTE LIST> 
<FILE ATTRIBUTE STATEMENT>. 


<FAMILY STATEMENT> 
<FILE DEFAULT STATEMENT> 
<FILE RESIDENT STATEMENT> 


<IDENTIFIER> 


<IDENTIFIER> 
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RESTRICTION: 


The <FILE OEFAULT STATEMENT> may appear in <FILE 
DEFINITION>s but not itn <FILE DEFAULT DEFINITIUON>s 
CDETAULTS may not be nested). <FAMILY STATEMENT> may not 
app2ar tna <FILE DEFAULT DEFINITION>. 


SEMANTICS: 


The fil2 section associates stations that are part of an NOL network 
with renote files of user programs. 


FILE DEFAULT STATEMENT 


SYNTAX 


<FILE DEFAULT STATEMENT>:s:s= DEFAULT = <FILE DEFAULT IDENTIF IE R> 


SEMANTICS: 


The <FILE DEFAULT STATEMENT> is used in the same manner that a 
<TERMINAL DEFAULT STATEMENT> is used. The <TERMINAL OEFAULT 
STATEMENT> is discussed under the description of terminal default 


semanticse 
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FAMILY STATEMENT 


SYNTAX: 
<FAMILY STATEMENT>:3 = FAMILY = <STATION FAMILY> 
<STATION FAMILY>32= -<STATION IDENTIFIER LIST> 


i DUMMY 


<STATION LDENTIFIER 

LIST>»3:= <STATION IDENTIFIER> 

1 <STATION [DENTIFIER>» <STATION 
IOENTIFIER LIST> 


SEMANTICS: 


The <FAMILY STATEMENT> Lists the names of stations which are to be 
considered members of the file being described. A station can be 
associated with any number of files and it can also be referenced 
any nunber of times in any one file. If DUMMY is used» it means 
that ¢€1) an MCS must assign the stations: to be assoctated with the 
file at open time and» (2) the number of stations assigned must be 
equal to or less than the number of stations declared in the file 
statement of the opening user program. 
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FIL RESIDENT STATEMENT - 


SYNTAX: 


<FILE RISIDENT 
STATEMENT>:2= RESIOENT 
1 RESIDENT 


CORE 
O1SK 


ib ou 


SEMANTICS: 


The fil2 resident statement locks the ‘user program in core if 
resident equals core. Otherwisar it 1s oaged out after each remote 
file read or write. The default ts RESIOENT = CORE. 
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NDL LIBRARY 


The Network Definition Language (NDL) Library consists of procedures 
used #1 the operation of on-line terminals that interface with 
B1700-Series computers. NDL Library tis a source language’ library 
that contains the REQUESTs and CONTROLS necessary to handte common 
line disciplines for the terminal devices referenced herein. By 
utilizing the library» users should find it unnecessary to write 
their oan REQUESTs and CONTROLs. 


ACCESSING THE LIBRARY 


The library of Line desciplines described herein is ae released 
product in the NDL system and is named "NDL/LIBRARY™. 


This liograry consists of a number of groups of source’ statements 
coded in NOL (Network Definition Language)» each group constituting 
a logical entity. These groups fall into two classes: those called 
REQUESTs and those called CONTROLs. 


Including the appropriate $ LIBRARY statement in a compile deck 
places any of these entities» intact» into an NDL compile. For 
instanc2» "$ LIBRARY POLLTD700", when placed correctly in a 
compilation deck passed to the NDL compiler» wilt cause all source 
statements in the entity named POLLTDO700 from the NOL/LIBRARY file> 
to be irtcluded into the source passed to the compiler. 


A typical compilation deck will appear as follows: 


2CO4PILER HANOLER WITH NOL TO LIBRARY? 
2DATA CARDS 
DECLARATION? 
NIF= "HANOLER*/"NIF". 
$LI3RARY POLLTO700 
SLIZRARY SELECTO700 
BLISRARY POLSELCTL 
<TERMINAL SECTION STATEMENTS> 
“STATION SECTION STATEMENTS> 
<LINE SECTION STATEMENTS> 
<FILE SECTION STATEMENT S> 
FINI. 
PEND; 
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This deck with the <SECTION STATEMENTS> appropriately filled in 
Witl, with the aid of an applications program» communicate to a 
network composed of either T0700 or T0800 terminals» or some 


combination of both. 


Note: The & LIBRARY cards take the place of NOL 
executable statements tn the deck. The 
compiler will replace these $ LIBRARY cards 
with actual source statements found in the 
NOL/LIBRARY file under the entity named 
POLLTD700 or SELECTD700 etc. 
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ASSOCIATIVE MATRICES: 


CONTROL 


SK RKEAKKEKKAKAKEAREMREE ERK KEKE KEKE HEE KK EKER EE KKKKEKEKEKEKKEEKEEKE EEK 


& 1 * 2 * 3 & 4 i 5 * 6 « 

kkk khkhkkh kk kk kkk kkk kkkk kk kk kk kkk kkk keke KKK KKK KKKh kk kkkk kk kk kk kk ak kkkee 
POLLTETD * x * X * * * * * 

& & & & * * & 
POLTCTODYN* * * * * * X * 

te & * * * * « 

READTTY * * * X * * * * 

* * * * * * t 

TOSPTRCV * * X * * * * 

R & . * * * * t& * 
TO7PTRCV «* * * x * * * * 

EE * * t& * & ra t 
SELECTCTD * X * X * * * * X * 

Q t * & t& * * 
FASTSZLTCO* X * X * & * * * 

U * * * * * * * 
WRITETTY * * te x * * te 

E * * * ir * * * 
TCSPTXMIT * * * X * * ra 

S & * « * * * * 
TO7PTXMIT * * * X * oF * * 

T * & * t * * & 
TCSPT?IO * * * te X * * * 

& * & « « t & 

DIAGTCTDIO* X * X * te * * fe 

* « * *« * * * 

RJE * rs .* ote * X * & 


kee REE EEE KE RE KKK EERE KEKE KEKE KK KEKE KK KAKA KE KRKAKKEKK KK KKK Kk Ek 


CONTROLS 
“4 = POLSELCTL X = RECOMMENED USAGE 
2 = AUTIPOLCTL | 
3 = PIPTCONCTL 
4 = CONVERTL 
5 = RJECTL 
6 & AUTIDYNCTL 
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REQUEST VS. TERMINAL 


TERMINAL 


kkk kkk kkkekek ke ak kkk keke kkaekk kk kk khkkk kkk kkkkke kk ak kkkeke 


* TC500 * * te i * 

* TC700 * TD70)0 * * * REMOTE * 

*« T03500 * 70800 * TU500 * TELETYPE *.APPLICATIONS «* 

fete ke tk aK KK KKK KEKE KEKE KKKKEKK KE KK KEKKKKAKKEKKEKKKKEKKKKKKKE 
~POLLTSTD « X # x * XxX * & 
* & * * * * 

POLTCTODYN*« X * X * X * * * 

* * * * * * 

READTTY * t & * xX & * 

* * * * * * 

TCSPTRCV «* X * & * * 

* * * * * * 

TO7PT%CV Of * X * « * 

R & * * & t& * 
SELECTCTD * x * X *« Xx & 

E * * *® * * * 
FASTS=LTCD« X al X * X * * * 

Q * * te te t « 
WRITETTY «* * * * X * rs 

U * * * * * * 
TCSPTXMIT * X al * * & 

E * * * * *& & 
TC7PTXMIT * * X * te * * 

S * * * *& * & 
TCSPT?10 * X  * * * * x 

T * * * * * & 
DIAGTZTDID« X * X x X * te * 

* * ? * * * * 

RJE * « & & X re 
KKK KEKE KK KKK KEKE KEKE KK KKK KKK KEE KKK KK KEKE KEKE KEKA KK EKKE KK KK KKK 


X = RECJMMENDED USAGE 
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USINS T4E NDL eis area * 


Controt card deck to compile a Network Controller with the NOL 
Compiler is as follows: 


2CIMPILE MYHANDLER WITH NOL TO LIBRARY 
2DATA CARDS 


CNJL SOURCE) 


PEND 


Note: "2" indicates an invatid punch in column 1 for 80-column cards. 


* Sectian wilt be completed at: a tater date. 
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NE WSO 


LINE 


NOL/N 


NDLZA 


CUSER 
NDL/M 
AUDIT 


NDOLZL 


CUDE 


Note: 


COMPILER INPUT ANO OUTPUT FILES 


NAL NAME INTERNAL NAME MEDIUM USE 
CARDS CARDS Primary 
source input 
e SOURCE DISK Secondary source 
input 
JRCOE NEWSOURCE DISK New secondary 
source Cout put) 
LINE PRINTER Listing 
[F NIF DISK Output network 
information file 
JORESS ADDRESS DISK Address file 
output by MACRO for 
compiler Cinput) 
“CHOSEN) OBJECT DISK Object code file 
of user's handler 
A CRO MACRO : DISK Skeletal controller 
. code file Cinput) 
~FPBS AUDIT.FPBS DISK Workfile 
[BRARY LIBRARY OISK Standard request 
. and control source 
code library 
CODE DISK Workfile 
NDL/MACRO and NDOL/ADDRESS must be ‘present on disk at BOJ of 


the compiter. SOURCE Cor user's lLabel-equated file) must be 
gresent if SMERGE is used- NOL/LIBRARY must be .present if 
are part of the release package. 
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NDL SOURCE FORMAT 


The fornat of the NOL source record is as follows: Card cotumns 17°72 
inclusive are the free form source field. Column 72 is’ tlogicaltly 

adjacent to column 1 of the next carde so identifiers» numbers» 

strings» etc. may be continued on the next card. 


Card columns 73-80 are reserved for sequence numbers» if desired. 


Comments: Occurrence of a percent sign (Z) in cotumns 1772 results 
in tne compiler skipping to column 1 of the next card. Any 
desired comment text may b2 entered following the “%*. 
Percent signs are part of the NDL sources however» if they 
appear within an <EBCODIC STRING>. For ‘example: 


FETCH CHARACTER. 4% ANY COMMENT.» « © a 
TRANSMIT “LEGAL 2". % PERCENT WITHIN QUOTES IS LEGAL 


Z THIS WHOLE CARO IS COMMENTS. «~ 


A dollar sign ($) in column 1 signals the compiler that the card 
contains compiler CONTROL statements (See, next section). 
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COMPILER CONTROL STATEMENTS 


Compiler execution options are specified by means of primary source 
records with a dollar sign (€$) in column 1. The options cover’ the 
areas of List format error/warning handling» source’ maitnt-enances 
changing stack sizes» and accessing the NOL source code library. 


<COMPILZR CONTROL 
STATEMENT>33= <"8™" IN COLUMN 1> <OPTION LIST> 


<OPTION LIST>::= <OPTION> ¢( NO <OPTION> 
{ <OPTION> <OPTION LIST> 
{1 NO <OPTION> <OPTION LIST> 


<OPTION>::= CHECK 

| | CODE 

CONTROL 

<DBUG OPTIDN> 
DOUBLE 
FORGETERRORS 

LIST 

LST 

MERGE 

NEW 
<SEQUENCE OPTION> 
SGL 

SINGLE 

<STACK SIZE OPTIQON> 
SUPPRESS 

<LIBRARY OPTION> 
<VOID OPTION> 


<DBUG ODO? TION>:s= DBUG <DBUG LIST>. CNON“RELEASE) 

- <DBUG LIST>::= | <INTEGER>I<INTEGER>s» <DBUG LIST> 
<SEQUENCE OPTION>:2= SEQ <SEQ BASE> <SEQ@ INCREMENT> 
<SEQ BASE>z3= | <INTEGER>I<EMPTY> 


<SEQ INIREMENT>::= #<INTEGER>1<EMPTY> 
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<STACK SIZE OPTION>::= CSSIZE <INTEGER> 


DYNAMICSIZE <INTEGER> 
NSSIZE <INTEGER> 
PPSSIZE <INTEGER> 
ESSIZE <INTEGER> 
VSSIZE <INTEGER> 


LIBRARY OPTION>::= LIBRARY <STANDARD IDENTIFIER> 
<STANDARD [DENTIFIER>32= <IDENTIFIER> 

<VOIJ OU? TION>: = VOID #? VOION <HIGH SEQUENCE> 
<HIGH SZQUENCE>: 2= <8=CHARACTER INTEGER> 


SEMANTICS: 


CODE 
CONTRIL 
CSSIZ= 

DBUG 

DOUBL: 
DYNAMICSIZE 
ESSIZ= 
FORGETERRORS 


LIBRARY 


LIST 


LOT 


Print warnings on sequence errors. A sequence’ error 
occurs when sequence of last card is greater than or 
equal to the current sequence number. 

List generated SDL-Machine S~OPS. 

List "$*™ cards 

Set CONTROL etait size of NC to <INTEGER> entries. 
Non-release.e. Compiler debugging options. 

Doublespace listing. 

Set NC's dynamic. memory to <INTEGER> bits. 

Set NC*s evaluation stack size to <INTEGER> entries. 
Generate object NC despite syntax errors. 

The NOL cource code specified by <STANDARD IDENTIFIER> 
is retrieved from the file "“NDL/LIBRARY™ and inserted in 


the user's program following the “LIBRARY” card. 


List source. 


List source. 
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MERGE Merge input -Cpatches in file "CARDS™") with secondary 
input ("SOURCE"). 
NEA Output a new secondary source file (C"NEWSOURCE™). 
NSSIZ= Set NC*s name stack size to <INTEGER> entries 
PPSSIZE Set NC's program pointer stack size to <INTEGER> 
entries. 
SEQ sequence the source beginning at <SEQ BASE> and 
incrementing the sequence - number by <SEQ INCREMENT>. 
Default is “SEQ 90000000 +100" (specified by just "SEQ™) 
SaL Single-space listing 
SINGL: Singlesspace listing 
SUPPR=SS Syntax warnings will not be printed. 
VSSIZ= Set NC*s value stack to <INTEGER> bits. 
VOID If <HIGH SEQUENCE> Is not specified» only the secondary 


source record with the current sequence number. is 
skipped by the compiler. otherwise» skip all. secondary 
source records beginning at current sequence number and 
continuing cilt a secondary source record is read with 
sequence higher than <HIGH SEQUENCE>. Note: VOID 
presumes $MERGE. , 


Prefacing an option with NO turns it off. For instance NO LIST stops. 
Listing of source records till SLIST 1s encountered. NO has _ no 


effect on VOID and LIBRARY. 


Defaults-“-all options are off except LIST» CHECK» and DOUBLE. 


Stack sizes are listed at the end of the compiler run and should 
suffice for normal operations but may be increased tif stack 
overflow occurs or decreased to tune to minimum memory requirements 


for special reasons. 
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The 
use 


RESZRVED WORDS 


following words may not be used as 


in the NDL syntax. 


ACC=ZSSERR 
ACU 

ADD=RR 
ADDRESS 
AND 

ASC5 3 
ASC54 
ASC58 
AUDIT 
AUDITFILE 
AUTJANSWER 
AUTIJPOLL 
BREAK 
BUF-ER 
CAL. 
CANZEL 
CARRIAGE 
CAS: 

CHAR 
CHARACTER 
CLEAR . 
COD: 
COMMENT 
CONSTANT 
CONTINUE 
CONTROL 
CONTROLLER 
CONVERT 
DEBJG © 
DECIMAL 
JECLARATION 
DECREMENT 
DEFAULT 
DIAsNOSTIC 
JIALIN 


DIA.OUT 


DISCONNECT 
DISPLAY 
DQ- 


ENDOF BUFFER 
EQ 

ERROR 

EVEN 
EXCEPTION 
FALSE 
FAMILY 
FETCH 

FILE 

FINI 
FINISH 

FOR 

FORMAT 
FORMATERR 
FREQUENCY 
GE 

GT 

HEADER 
HORIZONTAL 
IOLE 

IF 
INCREMENT 
INITIALIZE 
INITIATE 
INPUT 
INPUTATTACHED 
IODESC 

LE 
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LENGTH 


LINE 
LOGICALACK 
LOGIN 
LOSSOF CARRIER 
LOSSOFDSR 
LT 

MAX 
MAXINPUT 
MAXINWORK 
MAXOUTWORK 
MAXSTATIONS 
MCSQUEUE 
MEMURY 


OUTPUTATTACHED 
PAGE 

PARITY 

PASSIVE 

PHONE © 

POLL 

RECEIVE 

REMOTE 

REQUEST 


ac23 


identifiers because of their 


RESULTDESC 
RETRY 


" RETURN 


SCREEN 
SEC 

SECURITY 
SEQUENCE 
SIGNAL 
SPECIAL 

SPO 

STATION 
STORE 

SUM 

TALLY 

TASK 
TERMINAL 
TERMINALTYPE 
TERMINATE 
TEXT 

THEN 

TIME 

TIMEOUT 


TRANERR 
TRANSMISSION 
TRANSMIT 
TRUE 
TURNAROUND 
TYPE 

UNDO 
USER 
VERTICAL 
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RUNNING AN NOL CONTROLLER * 


NOR4AL OPERATIONS * 


EXECUTING * 


*Sectioyr wilt be completed at a Later date. 
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MEMORY» STACK SIZES 


in Bytes 


System static memory (MCP stacks» MCP zeror GISMO zero» CCC. ooo emma 


Conditiranal static CIOAT» eon bara a ee a ee ee ae ee ee eer ee ee ee ee ee ee ee 


System dynamic memory 


MCP zero=page resident COdRCe cece cece sescesccescscccseccvsecsese 
MCP code for NOL/QUEUE/REMOTE-FILE SUPPOPt eccccesvrwecesescoce 


MCP code for QUEUE-FILES (Crequired for active MCS) 


CONGVOCTOOA US & 666 66 eee eww OSs Sw ww oe eh SOS SW ow 6 we SSS Se a Sele 
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2. NDL CONTROLLER 


Basic * required static + required code t+ SOL/INTERP segments..-- 89137 


NOL tables and tablerrelated 
Linas 272 «Cnumber Lines) ecsececces = WITT 


Station: 75 *(number stns tl)ececees = TOT TT 
Terninal: 9 *€number terminalsdeces = 7747" - 
Fila2s 13 «(number (2 bGS 3) < caceeiwd cue =— Seen = 


NOL Table SU Mw aes eee eas ale eee een ee) eee ew oe eee ee eae ah etl ele et eee ee 


Requests +t Controls (See compilation) atic rere eee oe eee Se ee ee 


Queues and Messages 
Queue Directories: 27 * Copen Q-files 
# open remote fileasSdecccccevsccses = 


NDL Input Buffers: sum of “MAXINPUT™ 
for all UVO0GS6 d< oS6 sess Ce Se wee wees = 


NOL Output Buffers: sum of average 
oatoput text for all LineSeccecwesee = 77797" 


Queued Messages number * Caverage 
size text + O60: ):aw 6 66S See ew ke ae eee = as anaeoa 


Queue Messages SUM seclataratcawaase ew ss aura ee ws On ea aa een sen eee eeees 
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NOL CONDITIONAL ADDITIONS 


AUC D POLL ec wc ce ccewrccanse sw sersrccener ee esaessesaeceesesesccsesen 598 
+ Sum autopoll buffers Catt 9 HS) as woe ew wikis Se So S Soa oe ee we So eS hapa cesar aed -- 


Read no timeout CAutopoll >» TTY» RIE ea cere cece cesrcecvcceccves 454 


TEL 2 CY PpeS ce cccccccace cece sece reece csene creases cerssesecesveseces 130 


Audit = at LOC ASE cece wees ee de ee HCHO HS Os ROO HE SEC ORS COC ESS OC 1-106 


+ if 2 or 3 BUG 41 CE LUC S ob ee W 6s SAS See 66 6S KS OOS ow Os Se we 362 


+ if ON VER (ec. aie 6 eee oe ee Se Oa a We el we we alee Be eee SS bale a eee 152 


+ if Fibse buffers, CLC awa erecaecnenesesecensravsesneccececzenns 
+ GISMO segments sequential Tad ocean eee hoe a nee 


enhanced BED oerei siete 8 aieiis.sieince/ ea 2/90 Sas e's! sie: a 

TO a be ae. b Bebe: Saw A we a SS Gs aw we ew ele oe Sees 840 

Trarsmisston number incrementationescesccccecsccscccccencsece 164 
(not ARM character or 0/1 schemes) 

conversational Line disciplines ~ at Le@aStwsavsccccccccesuscvecece 273 


+t if "RECEIVE ADDRESS CSTATION)™ 15 uSedescceccccccccsscees 220 


MCS = at LOAS Ew bw ea aera e ob oo hw eee eeu S 6 Www Send ewetece cess 4338 


+ if LOGICALACK is USC De weve cccceces cece secereseccvecncesce 828 


- NOL Conditional Addition SUM waa ewe wo eS Swe Ue wo ew Ow Ow ewes oe & 


Subtotal 2: NDL basic + taosles # queues + conditional * # * «-ee-e-- 
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3. 4CSe if any> - = = = 5 = 5 + © Subtotal 32° 2 2 = 2 2 2 8 oe eeeeeee- 


4.2 USE? PROGRAMS 


Including additonal interpreters» MCP support code 
(e.ge MICR»e Random [/0)°- -Subtotal 4:- - = = = = = = © = = = em eeeen 


5- FUDZE FACTOR 


Leftover available» memory wasted in Link system + unknowns 
(required to provide non-thrashing system on real 1700 
Subtotal Si" - = = = = = = = = 2,000 


Add Subtotals 1°5. The sum is the minimum amount of 
S memory to hold the NOL system working set. TOTAL. «. .======= 


STOPPING 


DEBJGGING 


DEBUGS 
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IOLO0G 


The [O0LIG function provides for monitoring of att datacomm I[0 
activity through an external disk file labelled "OC"/"AUDIT.FILE™. 
A program "DC"/"AUDIT™ will read this file either in parallel with 
NOL or subdsequentlys formatting the information to the user's needs 
(See documentation on DC/AUDIT). 


To turn on IOLOG: 


Set DEBUG #28 in DBCARDS or type itn <CONTROL MIX 
NUM3ER> AXIOLOG on SPO. To turn off IOLOG, just 
rep2at the process: <CONTROL MIX NUMBER> AXIOLOG. A 
message Will appear on the SPO tndicating whether 
I0LIJG was turned on or off and the date and time. 


If DC/AJDIT~FILE is missinge a new file is created. A _ header 
provides information to "DOC"/"AUDIT™ indicating the first record 
Written by this job (Cirrelevant of turing I9JLOG off and on 
subsequ2ntly)» the next record to be written» and the total records 
written. The file wraps around on itself» so that more records may 
be Written than are accounted for in the AUDIT file. The size of 
the file is determined dynamically. If the fite is in use by 
another handler» a SPO message will so indicate. 


A comment record is always the first record to be written each time 
IOLOG ts set on. 


TRACE « 


*Sectionrn will be completed at a later date. 
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or station not enabled for 


118 

119 

120 
124°125> 
1269127» 
128136 
129134 
130 

131 
132133 
135 

142 

143 


144 
145 


146 
148 


149 
1590 
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RUNERRORS 


RUN ERROR LIST 


Parity Error ; 

Invalid station index returned by autopoll. 
DCWRITE error on present communicate. 

MACRO incompatible with the MCP. 

Initiate receive but no buffer. 

No poll List. 

No autopoll buffer or length zero. 

Invalid DCWRITE while queing input. 

Invalid DCWRITE while queing error message 
input. 
Receive text or terminate echo with no 
buffer or no text. 

Beginning of text misaligned. 

Transmit exceeded end of buffer. 
Invalid ODCWRITE while returning open message. 


Input 


Invalid NIF file. 


Network 1s too large. 

Main control loop exited. 

Invatid address file. 

Table size 1s too small. 

Station is invalid. 

Transmit text but no buffer. 

Station cannot be polled or string size does 
not agree with previous entry. 

Poll pointer ts invatid. 

Length of poll list is greater than 120 
characters. ; 

Invalid open text size length 

Message in station queue has length zero. 


Station attached to another line. 
Tried to receive 


COMPANY CONFIDENTIAL 
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input after shutdown started. 
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Error Originator 


Memory 
Controttler 
Controller 
Controttler 
NOL Code 
NOL Code 
NDL Code 
Controller 


Controller 
NOL Code 
NDOL Code 
NDL Code 
Controller 


Compiler 


Controttler 


Controtter 


Controller 
Compiler 
NOL Code 
NOL Code 


NOL Code 
Controller 


NOL Code 


. MCP 


MCP or 


User Program 


Controller 
NDL Code 
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151 Invalid DCWRITE while queing EOF for USER. 

PROGRAM Controller 
152 Transmit string is not 4008 bits. NOL Code 
170 Message length ts zero. MCP 
177 MCS message found but not expected. MCP 
180 Request definition is missing or wrong. NOL Code 
190 Invalid tnitiate. NOL Code. 
191 Control changed state to a different request. NDL Code 
192 Station cannot be changed. NDL Code 
193 Line has a station not in station List. Controller 


USING AN MCS « 


*Sectior will be completed at a later date. 
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NOL JUM? 


NOL/OUM? is a SOL program used for analyzing dump files created by 
MCP V.0 of the MACRO V.0. This analysis gives the NOL programmer 
information regarding his system status variables» his present 
network configuration and his lines» stations and terminals status. 
The duma analysis also contains information regarding the status of 
the MACRO» which ts transparent to the NDL user. This information 
can be used to debuq the MACRO. 


This dotument is for helping an NDL programmer understand the dump 
analysis.e- It is not however» for explaining how the MARCO works to 
an NDL usere Consequently the explanation of some variables is 
omitted. 


OPERATION 


Given a dump file named DUMPFILE/<NUMBER>» to use NDL/DUMP enter 
PM <NUMBER> NC 


on the SPQ. This command will start up NOL/DUMP. On EQJ» the dump 
file witk not be removed. 


If the dump file is not made of the MACRO or is of a MACRO of a 
wrong tlevel or some essential constant(s) (Ce-ege PPBPTR) are 
incorrect» NDL/DUMP will terminate ca ela indicating that the 
dump file was not valid. 


DATA FORMATS 


There are aonumber of formats which are used to print the various 
data items of the MACRO. In generals» the obvious interpretation 


should 3e correct. 
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DECIMAL 


ALl data items which are bit(€24) or less and are not absolute 
address2s are printed as decimal numbers. Fixed fields are also 
printed as decimal numbers» but they are preceeded by a “#" or a 


HEX 


ALt data ttems which are surrounded by “a3" signs are printed tn hex. 


- CHARACTER 


ALt character fields which contain valid characters are printed as 
they ares character fields which contains invalid character(s) are 
printed in hex. 


ASCII 


Datacomn buffers are printed in this format. In this format a 
printable character is printed as itself and an invalid character 
is printed vertically in hex. For examples the string: 


a01C1F102C1C2C 30 3a 


is printed as: 


OA1LOABCO 
1 2 3 
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SPECLTAL FORMATS 


Alt 20 2it data items which contain the time of day in tenths of 
seconds are printed in standard HH?MM:S55 format. 


The fietds of LINE.TYPE and LINE.STATUS are interpreted. 


Debug baoleans are printed by name when set. 


DUMP ANALYSIS QUTLINE 


The following is an outline of the output of NOL/DUMP. Note that the 
Last three items are printed only when applicable. 


1. Header page 

2- Global data items 

3e Terminal tables 

4. Station tables 

5e- Line tables 

62. Queue headers 

7. Active CONTROL or REQUEST 
8. Local variables 


The MAC?0 version data is obtained from the NIF. If the NIF is not 
present» this date field will be printed as blanks. If the NIF 
indicat2?s that the MACRO level is not compatible with NOL/DUMP, 
then an error message is printed out and NOL/DOUMP will terminate. 
The othar. parameters in this page are obtained from the PPB. 


GLO3ZAL VARTABLES 


The gloxal variables are printed out in order of their declaration 
in the 4ACRO. 
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TABLE INDEXING 


The network description as specifed by an NDL program is stored in 
the MAC?0 tables. These tables are declared as one data item in the 
MAIN-CONTROL procedure of the MACRO. The information in these 
tables is accessed by using indexinge The gtobal variables L.I» S.I 
and T.I are respectively the Line table index» station table index 
and t@rminal table index. The terminat tables are stored 
sequentially starting at the index TERMINAL.-TABLE.FIRST Ca global 
variable). There are MAX.TERMINALS terminal tables. Simitlary 
STATION.j TABLE-FIRST CLINE~TABLE~FIRST) and MAX.~STATIONS CMAX.LINES) 
indicat? the number and starting index of the station (Cline) 
tables. 


NDOL/IUM? prints out the terminal tables first followed by the 
statton tables followed by the tine tables. All references to these 
tables are done through the index. [In other wordss the index of the 
table of the third line identifes that tine. <A tabte index is 
always printed in decimal. 


DEBUGS 


If any debug booleans are set or debug table has a non-zero entry» 
the aopropriate name of the debug boolean will be printed out in 
the glosal variable section. These booleans are printed out between 
FILE-RESEDENT and HDR.DCW. 


MACXO TABLES 


The MAC?0 tables are printed in the order described itn TABLE 
INDEXING. The entries tn these tables are either status indicator 
or system constants set by NDL.~ In section NOL*MACRO VARIABLES 
XREF» the crosstreference between NDL and the MACRO is”) presented. 
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TABLE HEADER 


Each taadle has a header of the following format: 


- TERWINAL 
STATION TABLE <NUMBER> (<IDENTIFER>J <INDEX> 


LIN: 
The Line table has in addition below the header> the hardware 
address of this particular tine. This address is printed in the 
following format: 


port channel adapter 


number number number 


The identifier in the header is the actual NDL source name for’ the 
Line station or terminal to which the table is referring to. This 
identifier is obtained from the NIF. If the NIF is not’ present 
during execution of NOL/DUMPs blanks are put in place of the 
identifier. The index in the header is the indexed described in 
TABLE INDEXING. 


STATION QUEVE HEADER 


If a station has an active queues its header will be printed out 
after the station TALLYS and TOGGLES. The format of the header is 
descrio2d in QUEUE HEADERS. 


LINE WORK AREAS AND BUFFERS 


For each Lines» the input and output work arease» poll list» and input 
and output buffers Cif present) are printed out in ASCII format at 
the end of each Line table. 
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THE al, ACTIVE ON A LINE 


To find the station attached to a given line at dump times use the 
following formula: 


tndex=STATION.LISTCFIRST -STATION-NOtLINE.CURRENT.STATION.NO@=1) 


This index identifies the desired station. 


GENZRAL INFORMATION 


This se2ction of the dump analysis is opttonal--it ts only = printed 
when the information needed is present. 


QUEUE HEADERS 
When activey the following queue headers are going to be printed 
out: 

1. General input queue 

2e General output queue 

36 MCS queue 

4. Control queue 


The fornat of these headers is as follows: 


JQ.HEADS Q.FAMILY-NAME/Q.OFFSPRING.NAME 2Q.TAILA Q.USER.COUNT 
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CONTROL AND REQUEST NUMBERS 


If the NOL program has an active CONTROL or an active REQUEST» the 
dump aralysis will indicate the number of such a control and/or 
request. This number is a index to the order in which the controls 
or requ2sts are declared. For example» the first request in the NDL 
program is numbered 1. 


LOCAL VARIABLES 


The tocal variables of all procedures that are envoked after the 
MAIN-CONTROL procedures are printed out at the end of the dump 
analysis. 


Each procedure'ts data items its preceeded by the header of the 
following format: 


EXITED -EXIC LEVEL <number>-ENTERED LEXIC LEVEL<number>(€<procedure name>] 


Note that the procedure name is an option which depends on whether 
the NMP2?C conditionat compile ‘is set for the MACRO compile. 


DATA ITEMS FORMAT 


The fornat of the local data items is as follows: 
<Data Type> <bit Length> (Cdecimal value)] <value> 


The decimal value is printed if <bit tength> is less than or equals 
24. The value is printed in hex unless <data type> equals CHARACTER 
and value has valid characters. In this case <value> is printed out 
directly. 
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NDL*“MAC2Q VARIABLES XREF 


This cross reference is by no means” a 
MACRO*s variables and NDL. [t 
programner who 


SYSTEM STATUS VARIABLES 


NDL/DUMP Section 
(See Dutline 4.0) 


NDL System Status 
Variables Names 


LINE TABLE 
STATION TABLE 
STATION TABLE 
LINE.TABLE 
LINE.-TABLE 
LINE.TABLE 
LINE.TABLE 
LINE. TABLE 
LINE.TABLE 
LINE. TABLE 
LINE.«TABLE 
LINE. TABLE 


CHARACTER 
FREQUENT YCINPUT) 
FREQUENC YCOUTPUT ) 
IDDESC 
INPUTATTACHED 
OUTPUTAT TACHED 
LENGTHCINPUT ) 
LENGTHCJUTPUT) 
LINE 

LINECCONTROL KEY) 
LINE CQU-UED) 
MAXSTATIONS 


RESULTD=SC LINE.«TABLE 
RETRY STATION TABLE 
STATION LINE.TABLE 


STATIIN TABLE 
STATION TABLE 
GLOBAL ARRAY ~ 
STATION TABLE 
STATION TABLE 
STATION TABLE 
TERMINAL TABLE 
from CP 
STATION TABLE 
STATION TABLE 
GLOBAL VARIABLE 
STATION TABLE 
LINE.~TABLE 
STATION TABLE 
LINE.TABLE 
STATION TABLE 


STATIONCENABLED ) 
STATIONCMYUSE). 
STATION( QUEUED) 
STATIONCREADY) 
STATIONC TYPE) 
STATLONCVAILD) 
TERMINAL TYPE 

TIME | 
TRANCREZEIVE) 
TRANCTRANSMIT) 
ERROR FLAGS 
TOGL<INJEX>] 
LINECTOSC<INDEX>)) 
TALLYC<INOEX>] 
LINECTA_LYC<INDEX>1) 
TIMECTALLY) 


comolete map 
is ment to be helpful to the 


is not famitiar with the MACRO 


14-8 


COMPANY CONFIDENTIAL 
BL700 NETWORK DEFINITION LANGUAGE 
2212 


5223 


inner works. 


MACRO Variables 
Names 


LINE.CHAR.BUFFER 
INPUT.~PRIORITY 


OUTPUTSPRIORITY 


IN.DESCRIPTOR 
INPUT.BUFFER.VALID 
OUTPUT.~BUFFER.VALID 
INPUT. BUFFER.JLENGTH 


“DCW. SIZE 


NUMBER 
CONTROL.KEY 
QUEUED 
MAX.STATIONS © 
[0.REQUEST 


- RETRY-COUNT 


LINE.CUR.-STATION.NO 
ENABLED 

MYUSE | 

STATION. Q 

READY 

CONTROL.~LINK 

VALID 


INPUT. TRAN.NO 
OUTPUT. TRAN.NO 
DESCRIPT.ION.ERRORS 
STATION TOGGLES 
LINE TOGGLES 
STATION TALLYS 
LINE TALLYS 
TIME.TALLY 


between 


the 
NOL 


Special 
Notes* 


#1 


#2 


#3 


#4 


#S 


#6 
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*SPECIAL NOTES: 


Le Part of the first two descriptiors is stored in 
this field. Each of these parts consists of the 
following consecutive 24 bit fields: 


I0.ACTUAL~END 
IO-RESULT 
IO.LINK 

10.0P 
I0.BEGIN 
I0.END 


2 « If this field is greater than QO» the QUEUED has 
a value of trues, otherwise QUEUED is false. 


Se This fietd is a concatination of the 10.RESULT 
fields of the first two IO0.-DESCRIPTOR fields. 


ae If this field is greater than O» STATIONCQUEUED) 
is true» otherwise STATIONCQUEUED) is false. 


56 The following are the possible values and 
corresponding meanings of this field. 


a0a means NORMAL 
aFa means CONTROLLER 
anything else means SLAVE 


be The specific error flags are bits o f 
RESULT-DESCRIPTOR: 


Bit 1 2: PARITY Bit 7 : LOSSOFOSR 
Bit 2 3: ACCESSERR. Bit 8 =: LOSSOFCARRIER 
Bit 3 : Not used Bit 9 =: ADDERR 
Bit 4 3: TIMEOUT Bit 10: TRANERR 
Bit 5 3: READ Bit 11° FORMATERR 
Bit 6 =: ENDOFBUFFER Bit 12: Not used 
Bit 13:3 EXCEPTION 


BURRUJUG4S CORPORATION 
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TERYWINAL SECTION 


NOL Terminal Statement 


IDENTIFIER 

A4EADER SIZE 
YAXINPUT ADORESS 
DIAGNOSTIC REQUEST 
REQUEST 

TYPE 

TRANSMISSION NUMBER 
ADDRESS 


STATION SEC TEON 


LDENTIFIER 
>ONTROLLER 
“REQUENCY 
-~OGICALACK 
4CS QUEVED 
MYUSE 
ADDRESS 
TERMINAL 
RETRY 


LIN= SECTION 


NOL Line Statement 


IDENTIFIER 
AUTOPOLL SIZE 
ADDRESS 
SONTROL 
STATION 

TYPE 

MAX INWORK 
MAXOUTWORK 
MAXSTATIONS 
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“NDL/DUMP Terminal Table Variable 


Tabie Identifier 

HEADER. SIZE 

INPUT.MAX.MSG 

DIAG. QOUTPUT.REQUESTC(DIAG. INPUT. REQUEST) 
OUTPUT. REQUESTCINPUT. REQUEST) 
TYPE 

NO.SIZE 
QUTPUT.~ADRS~SIZECINPUT.ADRS.SIZE) 


NDL/DUMP Station Table Variable 


Table identifier 

CONTROLLER 
INPUT.PRITORITYCOUTPUT. PRIORITY) 
LOGICAL.ACK 

MCS-EXPECTED (this is a globat variable) 
MYUSE 
INPUT.~ADDRESSCOUTPUT.ADDRESS) 
TERMINAL.LINK 

RETRY.~COUNT 


NOL/DUNP Line Table Variable 


Table [Identifier 
POLL~-LIST.LENGTH 
Port:Channel: Adapter 
CONTROL.LINK 
STATION.LINK 

TYPE 

INPUT.WA.LENGTH 
OUTPUT. WA.LENGTH 
MAX-e-STATIONS 
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FIL= SECTION 


The arrays 


in the global section contain 
station pelong to which family. The following is a method to’ find 


this information. 


Look. in FILE-NAME array for the family name. 


Get the index into this array which points to the 
given family name. This is the family number. 


The station number is the index into. the station 
identifier list in the NOL family statement. Note 
that this index starts with O value. 


FILE~STATILON-LIST.PTR (family number + station 
number) its your station pointer. 


FILE.STATION«-LIST (station pointer) is the 
station list pointer. 


STATION-LIST (station list pointer) is the index 
into the station table. 


B1700 NETWORK OEfFINITION LANGUAGE 


information regarding which 


ACCESSING THE LIBRARY 
ASCII 

ASSIGVER 

ASSIGNMENT STATEMENT 
ASSOCIATIVE MATRICES 
AUDIT STATEMENT 
AUDIT- ILE DECLARATION 
AUTOPIJLL SIZE STATEMENT 
BASIC COMPONENTS 
BASIC ELEMENTS OF THE LANGUAG 
BRACK=TS 
CASE STATEMENT 

CASE STATEMENT 

CHARACTER 

CHARACTER SET 

CODINS AIOS 

COMPILER CONTROL STATEMENTS 
COMPI-ER INPUT AND OUTPUT FILES 
CONSTANT DECLARATION | 
CONTINUE STATEMENT 

CONTRIL AND REQUEST NUMBERS 
CINTRIL CARDS 

CONTRIL INITIATE STATEMENT 
CONTRIL SECTION 

CONTRILLER STATEMENT 

DATA -ORMATS 

DATA LTEMS FORMAT 

DEBUGSING 

DEBUGS 


DECIMAL 

DECLAYATION SECTION 
DECREYENT STATEMENT 
DISPLAY STATEMENT 


DO STATEMENT 

DO STATEMENT 

DUMP «& 

DUMP ANALYSIS OUTLINE 
ERROR FLAGS 

EXECUTING * 
EXPRESSIONS 

FAMILY STATEMENT 

FETCH STATEMENT 

FILE JEFAULT STATEMENT 
FILE RESIDENT STATEMENT 
FILE SECTION . 


FINISA STATEMENT 
FREQUZINCY STATEMENT 
GENERAL 

GENERAL INFORMATION 


ALPHABETIC INDEX: 
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GLOBA. VARIABLES 
HEADE? PAGE 
HEADER SIZE STATEMENT 
HE X 

IDENTIFIERS 

IF STATEMENT 


INCREYENT STATEMENT 
INITIALIZE STATEMENT 
INITIATE STATEMENT 
INTEG=RS 

IOLOG 

LINE ADDRESS STATEMENT 
LINE JEFAULT STATEMENT 
LINE SECTION 


LINE STATION STATEMENT 
LINE TYPE STATEMENT 
LINE WORK AREAS ANDO BUFFERS 
LOCAL VARIABLES 

LOGICAL VALUES 
LOGICALACK STATEMENT 
MACRO TABLES 

MAX TALLY/TOG DECLARATION 
MAXIN? UT STATEMENT 
MAXINAORK STATEMENT 
MAXOUTWORK STATEMENT 
MCSQUZUE STATEMENT 
MEMORY» STACK SIZES 
METALENGUISTIC FORMULAS 
METALINGUISTIC SYMBOLS 
MYUSE STATEMENT 

NDL DJMP 

NDL LIBRARY 

NDL SJURCE FORMAT 
NDL-MACRO VARIABLES XREF 
NIF NAME DECLARATION 
NORMA. OPERATIONS « 
NULL STATEMENT 

NULL STATEMENT 
OPERATION 

OPERATORS 

POLL STATEMENT 
PREPAVING PROGRAMS * 
PRIORITY * 

PRICEJURE HEADER FORMAT 
QUEUE HEADERS 

RECEIVE STATEMENT 
RELATZIO PUBLICATIONS 
REQUEST SECTION 

REQUEST VS. TERMINAL 
REQUESTS VS. CONTROL 
RESERVED WORDS 

RETRY STATEMENT 

RUN ERROR LIST 
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RUNERZORS 

RUNNING AN NDL CONTROLLER * 
SECTIIJNS OF AN NDL PROGRAM 
SEPARATORS 

SIGNAL DECLARATION 

SPECIAL FORMATS 

STATIIN ADDRESS STATEMENT 
STATIIN DEFAULT STATEMENT 
STATIIN QUEUE HEADER 
STATIIN SECTION 

STATIIN SECTION 

STATIIJN TERMINAL STATEMENT 
STOPPING 

STRING FUNCTIONS 

STRINGS 

SYNTAX CONVENTIONS 

SYSTEY STATUS VARIABLES 


TABLE HEADER 
TABLE INOEXING 
TERMINAL ADDRESS STATEMENT 
TERMINAL DEFAULT STATEMENT 
TERMIVAL DIAGNOSTIC REQUEST STATEMENT 
TERMINAL REQUEST STATEMENT 
TERMINAL SECTION 
TERMINAL SECTION 
TERMINAL TYPE STATEMENT 
TERMINATE STATEMENT 
THE STATION ACTIVE ON A LINE 
THE STRUCTURE OF NOL 
TRACE * 
TRANSYISSLON NUMBER STATEMENT 
TRANSYIT STATEMENT 
UNDO STATEMENT 


USER TALLIES 
USER TOGGLES 

USING AN MCS * : 
USING THE NOL COMPILER * 
VARIA3LES 
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